文档 Grafana Alloy 参考 组件 otelcol otelcol.receiver.file_stats

otelcol 接收器 FileStats

otelcol.receiver.file_stats 从使用glob模式指定的文件和文件夹中收集指标。

可以通过为它们提供不同的标签来指定多个 otelcol.receiver.file_stats 组件。

用法

alloy 复制

otelcol.receiver.file_stats "LABEL" {
  include = "GLOB_PATTERN"

  output {
    metrics = [...]
  }
}

参数

otelcol.receiver.file_stats 支持以下参数

include 是一个 glob 模式，用于指定要收集统计信息的路径（文件和文件夹）。* 字符匹配目录中的条目，而 ** 包括子目录。例如，/var/log/**/*.log 匹配 /var/log 中所有以 .log 结尾的文件和目录。

timeout 参数控制由 collection_interval 指定的每次收集的超时时间。超时适用于 include 参数匹配的所有路径的整个收集过程。

块

以下块在 otelcol.receiver.file_stats 的定义中受支持

metrics block

metrics 块配置将发送到下游组件的指标集。它不接受任何参数，但包含用于单个指标的块。

• 有关 file.atime 块的详细信息
• 有关 file.count 块的详细信息
• 有关 file.ctime 块的详细信息
• 有关 file.mtime 块的详细信息
• 有关 file.size 块的详细信息

有关单个指标块是否默认启用的详细信息，请参阅指标块的文档。

file.atime 块

file.atime 块配置 file.atime 指标。 file.atime 跟踪自上次访问文件或文件夹以来经过的时间，以自纪元以来的 Unix 秒计算。

file.count 块

file.count 块配置 file.count 指标。 file.count 跟踪指定 glob 模式中文件和文件夹的数量。

file.ctime 块

《file.ctime》块配置了《file.ctime》指标。《file.ctime》追踪自文件或文件夹上次变更以来经过的时间，以自纪元以来的Unix秒为单位。变更包括权限、所有权和时间戳。

file.mtime块

《file.mtime》块配置了《file.mtime》指标。《file.mtime》追踪自文件或文件夹上次修改以来经过的时间，以自纪元以来的Unix秒为单位。

file.size块

《file.size》块配置了《file.size》指标。《file.size》追踪文件或文件夹的大小，以字节为单位。

resource_attributes块

《resource_attributes》块配置发送到下游组件的指标资源属性。它不接受任何参数，但包含其他用于配置单个资源属性的块。

• 《a href="#filename-block">file.name》块
• 《a href="#filepath-block">file.path》块

请参阅各个资源属性块的文档，以确定该资源属性是否默认启用。

file.name块

《file.name》块配置《file.name》资源属性。

当enabled为true时，file.name属性包含在所有指标中。

子块metrics_include和metrics_exclude可用于进一步过滤哪些指标被赋予file.name属性。如果一个指标与所有metrics_include块匹配且与所有metrics_exclude块都不匹配，则添加file.name属性。

metrics_include块

《metrics_include》块配置匹配指标的过滤器。《metrics_include》块可以指定多次。

必须指定strict或regexp之一。

metrics_exclude块

《metrics_exclude》块配置排除指标的过滤器。《metrics_exclude》块可以指定多次。

必须指定strict或regexp之一。

file.path块

《file.path》块配置《file.path》资源属性。

当enabled为true时，file.path属性包含在所有指标中。子块metrics_include和metrics_exclude可用于进一步过滤哪些指标被赋予file.path属性。如果一个指标与所有metrics_include块匹配且与所有metrics_exclude块都不匹配，则添加file.path属性。

debug_metrics块

《debug_metrics》块配置此组件生成的指标以监视其状态。

支持以下参数

《disable_high_cardinality_metrics》是Grafana Alloy对OpenTelemetry Collector中的telemetry.disableHighCardinalityMetrics功能门的等效项。它删除可能导致高基数指标的属性。例如，从HTTP和gRPC连接的指标中删除具有IP地址和端口号的属性。

level 是合金与 OpenTelemetry Collector 中的 telemetry.metrics.level 功能门等效。可能的值有 "none"、"basic"、"normal" 和 "detailed"。

输出块

output 块配置一组组件，将这些组件用于转发结果遥测数据。

支持以下参数

您必须指定 output 块，但所有参数都是可选的。默认情况下，遥测数据将被丢弃。根据需要配置 metrics、logs 和 traces 参数，以便将遥测数据发送到其他组件。

导出字段

otelcol.receiver.file_stats 不导出任何字段。

组件健康状态

当 otelcol.receiver.file_stats 以下情况发生时，会报告为不健康：

• 它被赋予无效的配置。
• 它在不受支持的操作系统上运行。

调试信息

otelcol.receiver.file_stats 不公开任何特定组件的调试信息。

示例

此示例通过批处理程序将位于 /var/log 的具有 .log 扩展名的文件和文件夹的文件统计信息转发，最后发送到一个 OTLP 兼容的端点。

alloy 复制

otelcol.receiver.file_stats "default" {
  include = "/var/log/**/*.log"

  output {
    metrics = [otelcol.processor.batch.default.input]
  }
}

otelcol.processor.batch "default" {
  output {
    metrics = [otelcol.exporter.otlp.default.input]
  }
}

otelcol.exporter.otlp "default" {
  client {
    endpoint = sys.env("OTLP_ENDPOINT")
  }
}

兼容组件

otelcol.receiver.file_stats 可以接受以下组件的参数：

• 导出 OpenTelemetry otelcol.Consumer 的组件