Skip to content

Consul Integration

Infrastructure Integration

Instructions

Follow the installation guide below for your given collector environment.

During installation, use the configuration section below as reference.

After installation, the infrastructure datasources in the table below will be available in the AOC.

Installation Guide

Installing this integration consists of creating a yaml file in the filesystem of your collectors. Click below for instructions on how to do so for your given collectors environment.

Docker

Kubernetes

Mesos-Marathon

Debian

Ubuntu

RHEL/CentOS

Configuration

  1. Edit consul.yaml to configure the agent. Please refer consul.yaml for all available configuration options.

    # This check takes no init_config
    init_config:
    
    instances:
        - url: http://localhost:8500
          catalog_checks: yes
          self_leader_check: yes
          new_leader_checks: yes
          network_latency_checks: yes
    
  2. Connect Consul Agent to DogStatsD by adding your dogstatsd_addr in the main Consul configuration file. Please nest it under the top-level telemetry key:

    {
      ...
      "telemetry": {
        "dogstatsd_addr": "127.0.0.1:8125"
      },
      ...
    }
    

    Reload the Consul Agent to start sending more Consul metrics to DogStatsD.

Infrastructure Datasources

Datasource Available Aggregations Unit Description
consul.catalog.nodes_critical avg max min sum node # of Nodes with service status critical from those registered
consul.catalog.nodes_passing avg max min sum node # of Nodes with service status passing from those registered
consul.catalog.nodes_up avg max min sum node # of Nodes
consul.catalog.nodes_warning avg max min sum node # of Nodes with service status warning from those registered
consul.catalog.services_critical avg max min sum service Total critical services on nodes
consul.catalog.services_passing avg max min sum service Total passing services on nodes
consul.catalog.services_up avg max min sum service Total services registered on nodes
consul.catalog.services_warning avg max min sum service Total warning services on nodes