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.

Configuration¶

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

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