datadog_metrics
editdatadog_metrics
editThis is a community-maintained plugin! It does not ship with Logstash by default, but it is easy to install by running bin/plugin install logstash-output-datadog_metrics
.
This output lets you send metrics to
DataDogHQ based on Logstash events.
Default queue_size
and timeframe
are low in order to provide near realtime alerting.
If you do not use Datadog for alerting, consider raising these thresholds.
Synopsis
editThis plugin supports the following configuration options:
Required configuration options:
datadog_metrics { api_key => ... }
Available configuration options:
Setting | Input type | Required | Default value |
---|---|---|---|
Yes |
|||
No |
|
||
No |
|||
No |
|
||
No |
|
||
No |
|
||
string, one of |
No |
|
|
<<,>> |
No |
|
|
No |
|
||
No |
|
||
No |
|
Details
edit
api_key
edit- This is a required setting.
- Value type is string
- There is no default value for this setting.
Your DatadogHQ API key. https://app.datadoghq.com/account/settings#api
codec
edit- Value type is codec
-
Default value is
"plain"
The codec used for output data. Output codecs are a convenient method for encoding your data before it leaves the output, without needing a separate filter in your Logstash pipeline.
dd_tags
edit- Value type is array
- There is no default value for this setting.
Set any custom tags for this event, default are the Logstash tags if any.
device
edit- Value type is string
-
Default value is
"%{metric_device}"
The name of the device that produced the metric.
exclude_tags
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is array
-
Default value is
[]
Only handle events without any of these tags. Optional.
host
edit- Value type is string
-
Default value is
"%{host}"
The name of the host that produced the metric.
metric_type
edit-
Value can be any of:
gauge
,counter
,%{metric_type}
-
Default value is
"%{metric_type}"
The type of the metric.
metric_value
edit<li> Value type is <<string,string>> * Default value is `"%{metric_value}"`
The value.
queue_size
edit- Value type is number
-
Default value is
10
How many events to queue before flushing to Datadog
prior to schedule set in @timeframe
tags
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is array
-
Default value is
[]
Only handle events with all of these tags. Optional.
timeframe
edit- Value type is number
-
Default value is
10
How often (in seconds) to flush queued events to Datadog
type
(DEPRECATED)
edit- DEPRECATED WARNING: This configuration item is deprecated and may not be available in future versions.
- Value type is string
-
Default value is
""
The type to act on. If a type is given, then this output will only
act on messages with the same type. See any input plugin’s type
attribute for more.
Optional.