« Datadog 输出插件 Dynatrace 插件 »
Elastic 文档 ›Logstash 参考 [8.14] ›输出插件

Datadog_metrics 输出插件

编辑

Datadog_metrics 输出插件编辑

  • 插件版本：v3.0.5
  • 发布时间：2023-05-31
  • 更新日志

有关其他版本，请参阅版本插件文档。

安装编辑

对于默认情况下未捆绑的插件，可以通过运行 bin/logstash-plugin install logstash-output-datadog_metrics轻松安装。有关更多详细信息，请参阅使用插件。

获取帮助编辑

如果您对插件有任何疑问，请在论坛中打开一个主题。对于错误或功能请求，请在Github中打开一个问题。有关 Elastic 支持的插件列表，请参阅Elastic 支持矩阵。

描述编辑

此输出允许您根据 Logstash 事件将指标发送到 DataDogHQ。默认的 queue_size 和 timeframe 较低，以便提供近乎实时的警报。如果您不使用 Datadog 进行警报，请考虑提高这些阈值。

Datadog_metrics 输出配置选项编辑

此插件支持以下配置选项以及稍后描述的通用选项。

设置 输入类型 必需

api_key

密码

是

dd_tags

数组

否

设备

字符串

否

主机

字符串

否

指标名称

字符串

否

指标类型

字符串，以下之一：["gauge", "counter", "%{metric_type}"]

否

指标值

<<,>>

否

队列大小

数字

否

时间范围

数字

否

另请参阅通用选项，以获取所有输出插件支持的选项列表。

 

api_key编辑

  • 这是一个必填设置。
  • 值类型为密码
  • 此设置没有默认值。

您的 DataDogHQ API 密钥。 https://app.datadoghq.com/account/settings#api

dd_tags编辑

  • 值类型为数组
  • 此设置没有默认值。

为此事件设置任何自定义标签，默认情况下为 Logstash 标签（如果有）。

device编辑

  • 值类型为字符串
  • 默认值为 "%{metric_device}"

生成指标的设备名称。

host编辑

  • 值类型为字符串
  • 默认值为 "%{host}"

生成指标的主机名称。

metric_name编辑

  • 值类型为字符串
  • 默认值为 "%{metric_name}"

时间序列的名称。

metric_type编辑

  • 值可以是以下任意值：gauge、counter、%{metric_type}
  • 默认值为 "%{metric_type}"

指标的类型。

metric_value编辑

  • 值类型为字符串
  • 默认值为 "%{metric_value}"

值。

queue_size编辑

  • 值类型为数字
  • 默认值为 10

在根据 @timeframe 中设置的时间表刷新到 Datadog 之前要排队的事件数

timeframe编辑

  • 值类型为数字
  • 默认值为 10

将排队的事件刷新到 Datadog 的频率（以秒为单位）

通用选项编辑

以下配置选项受所有输出插件支持

设置 输入类型 必需

编解码器

编解码器

否

启用指标

布尔值

否

ID

字符串

否

codec编辑

用于输出数据的编解码器。输出编解码器是一种方便的方法，可以在数据离开输出之前对其进行编码，而无需在 Logstash 管道中使用单独的过滤器。

enable_metric编辑

禁用或启用此特定插件实例的指标日志记录。默认情况下，我们会记录所有可以记录的指标，但您可以禁用特定插件的指标收集。

id编辑

  • 值类型为字符串
  • 此设置没有默认值。

向插件配置添加唯一的 ID。如果未指定 ID，Logstash 将生成一个。强烈建议在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有 2 个 datadog_metrics 输出。在这种情况下，添加命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  datadog_metrics {
    id => "my_plugin_id"
  }
}

id 字段中的变量替换仅支持环境变量，不支持使用密钥库中的值。

« Datadog 输出插件 Dynatrace 插件 »