2.1 KiB
| title | description | ha_category | ha_iot_class | ha_release | ha_domain | ha_integration_type | related | ha_quality_scale | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Datadog | Send data and events to Datadog. |
|
Local Push | 0.45 | datadog | integration |
|
legacy |
The Datadog {% term integration %} sends all state changes to Datadog using a Datadog Agent.
Datadog allows you to analyze, monitor, cross-reference and alert upon your data. You can use it to detect statistical anomalies, see graphs across multiple sources in real-time, send critical alerts to Slack, etc.
The integration also sends events from the logbook into Datadog, allowing you to correlate these events with your data.
Setup
You need to have a Datadog agent installed in a network accessible by Home Assistant.
In the Datadog Agent configuration, you must enable DogStatsD non-local traffic to allow StatsD data collection from outside localhost.
Configuration
To use the datadog integration in your installation, add the following to your {% term "configuration.yaml" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
# Example configuration.yaml entry
datadog:
{% configuration %}
host:
description: The IP address or hostname of your Datadog host, e.g., 192.168.1.23.
required: false
default: localhost
type: string
port:
description: Port to use.
required: false
default: 8125
type: integer
prefix:
description: Metric prefix to use.
required: false
default: "hass"
type: string
rate:
description: The sample rate of UDP packets sent to Datadog.
required: false
default: 1
type: integer
{% endconfiguration %}