tractr/logstash-input-cloudwatch

带有Cloudwatch插件的Logstash镜像

镜像概述和主要用途

本镜像为预安装Cloudwatch插件的Logstash镜像，主要用于从AWS Cloudwatch服务中获取指标数据和日志数据，实现对AWS资源的监控数据收集与集中处理。

源代码地址

GitHub: https://github.com/tractr/docker-images/tree/main/workers/logstash-input-cloudwatch

已安装插件

logstash-input-cloudwatch插件

用于从Cloudwatch获取指标数据。

详细信息请参见：Elastic官方文档

配置示例

text
input {
    cloudwatch {
        access_key_id => "AKXXXXXXXXX"
        secret_access_key => "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        namespace => "AWS/ECS"
        metrics => ["CPUUtilization", "MemoryUtilization"]
        filters => {"ClusterName" => "production-cluster"}
        region => "us-east-1"
    }
}

关于可用指标的更多信息：AWS CloudWatch指标文档

logstash-input-cloudwatch_logs插件

用于从Cloudwatch获取日志数据。

详细信息请参见：https://github.com/lukewaite/logstash-input-cloudwatch-logs

配置示例

text
input {
    cloudwatch_logs {
        access_key_id => "AKXXXXXXXXX"
        secret_access_key => "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
        log_group => "sample-logs-group"
        region => "us-east-1"
    }
}

参数说明

使用场景和适用范围

适用于需要集中收集、处理AWS Cloudwatch指标和日志的场景，例如：

• AWS资源监控数据聚合与分析
• 云服务日志集中存储与检索
• 基于Cloudwatch数据的告警与可视化

使用方法和配置说明

基本使用步骤

1. 创建Logstash配置文件（如logstash.conf），配置Cloudwatch输入插件（根据上述示例）
2. 通过Docker运行镜像，挂载配置文件

Docker运行示例

bash
docker run -d \
  -v /path/to/your/logstash.conf:/usr/share/logstash/pipeline/logstash.conf \
  --name logstash-cloudwatch \
  tractr/logstash-input-cloudwatch:latest

配置说明

• AWS凭证配置：可通过access_key_id和secret_access_key直接配置，或通过aws_credentials_file指定凭证文件路径
• 区域设置：通过region参数指定AWS区域，默认为us-east-1
• 日志组配置：log_group支持单个日志组或多个日志组（数组形式）
• 采集间隔：interval参数控制数据采集间隔，单位为秒，默认60秒