Logstash 日志服务 Output 插件
本插件作为Logstash的output插件，提供输出日志到日志服务的功能。
- RubyGems: logstash-output-logservice
安装步骤
- 将插件添加到Logstash中:
logstash-plugin install logstash-output-logservice- 查看安装的插件及其版本：
logstash-plugin list --verbose logstash-output-logservice配置示例
其中前7个参数 endpoint 到 max_send_retry 为必填项
其他参数为选填项
output {
logservice {
endpoint => "your project endpoint"
project => "your project name"
logstore => "your logstore name"
access_key_id => "your access id"
access_key_secret => "your access key"
source => ""
max_send_retry => 10
topic => ""
max_buffer_items => 4096
max_buffer_bytes => 2097152
max_buffer_seconds => 3
total_size_in_bytes => 104857600
send_retry_interval => 200
time_key => "@timestamp"
}
}
配置说明
| 参数名 | 参数类型 | 是否必填 | 备注 |
|---|---|---|---|
| endpoint | string | 是 | 日志服务项目所在的endpoint |
| project | string | 是 | 日志服务项目名 |
| logstore | string | 是 | 日志服务日志库名 |
| access_id | string | 是 | 阿里云Access Key ID |
| access_key | string | 是 | 阿里云Access Key Secret |
| source | string | 是 | 上传日志中的source字段 |
| max_send_retry | number | 是 | 上传失败重试次数 |
| topic | string | 否 | 上传日志中的topic字段,默认为"" |
| max_buffer_items | number | 否 | 发送缓存日志条数上限,默认为4096 |
| max_buffer_bytes | number | 否 | 发送缓存日志字节数上限,默认为2097152 (2MB) |
| max_buffer_seconds | number | 否 | 发送缓存日志时间上限,默认为3秒 |
| total_size_in_bytes | number | 否 | 缓存日志总字节数上限,默认为104857600 (100MB) |
| send_retry_interval | number | 否 | 上传失败重试间隔,默认为200毫秒 |
| time_key | string | 否 | 上传日志中的时间戳字段,默认为"@timestamp" |
开发参考
#代码编译
gem build logstash-output-logservice.gemspec
#发布
gem push logstash-output-logservice-VERSION.gem
#生成离线包
logstash-plugin prepare-offline-pack logstash-output-logservice常见问题
-
插件安装失败
由于网络问题，导致无法连接到默认的 RubyGems 源。- 配置国内镜像源，如Ruby China
-
权限配置
- 参考RAM自定义授权示例，确保插件有日志服务日志库的写入权限
-
日志上传失败
- 根据Logstash运行日志具体分析