cleanstart/logstash-exporter

Logstash-Exporter 容器文档

Logstash Exporter容器提供Prometheus指标导出器，用于Logstash监控与可观测性。它从Logstash实例收集并暴露关键性能指标、管道统计数据和运行数据，在企业环境中实现全面的监控和告警能力。

📌 基础架构：基于Cleanstart Registry的安全加固、最小化基础OS，专为企业容器化环境设计。

核心功能和特性

容器的核心能力与优势：

• 为Logstash监控提供Prometheus指标暴露
• 实时管道统计和性能指标
• 可定制的指标收集和导出间隔
• 低资源占用和高效运行

使用场景和适用范围

该容器擅长的典型场景：

• 企业Logstash监控与告警
• 性能指标收集与分析
• 运行健康监控
• SLA合规与报告

拉取最新镜像

从registry下载容器镜像：

bash
docker pull docker.xuanyuan.run/cleanstart/logstash-exporter:latest

bash
docker pull docker.xuanyuan.run/cleanstart/logstash-exporter:latest-dev

基本运行

使用基本配置运行容器：

bash
docker run -d -p 9198:9198 --name logstash-exporter docker.xuanyuan.run/cleanstart/logstash-exporter:latest

生产部署

使用生产环境安全设置部署：

bash
docker run -d --name logstash-exporter \
  -p 9198:9198 \
  --read-only \
  --security-opt=no-new-privileges \
  --user 1000:1000 \
  -e LOGSTASH_ENDPOINT=http://logstash:9600 \
  docker.xuanyuan.run/cleanstart/logstash-exporter:latest

卷挂载

挂载本地目录以持久化数据：

bash
docker run -d -p 9198:9198 \
  -v $(pwd)/config:/config \
  docker.xuanyuan.run/cleanstart/logstash-exporter:latest

端口转发

使用自定义端口映射运行：

bash
docker run -d -p 8080:9198 docker.xuanyuan.run/cleanstart/logstash-exporter:latest

环境变量

通过环境变量提供的配置选项：

安全最佳实践

推荐的安全配置和实践：

• 生产部署使用特定镜像标签
• 为指标端点实施适当的认证
• 配置网络安全和访问控制
• 定期进行安全更新和补丁管理
• 监控指标端点访问日志
• 对指标端点通信使用TLS

Kubernetes安全上下文

Kubernetes部署推荐的安全上下文：

yaml
securityContext:
  runAsNonRoot: true
  runAsUser: 1000
  runAsGroup: 1000
  readOnlyRootFilesystem: true
  allowPrivilegeEscalation: false
  capabilities:
    drop: ["ALL"]
  seccompProfile:
    type: RuntimeDefault

多平台镜像

bash
docker pull --platform linux/amd64 cleanstart/logstash-exporter:latest
docker pull --platform linux/arm64 cleanstart/logstash-exporter:latest

文档资源

进一步信息的必要链接和资源：

• CleanStart网站：[***]⁠⁠
• 文档：https://github.com/kuskoman/logstash-exporter
• CleanStart社区镜像：https://hub.docker.com/u/cleanstart
• 如何运行CleanStart镜像及示例项目：https://github.com/cleanstart-dev/cleanstart-containers，
  • 如何使用Dockerfile运行示例项目
  • 如何通过Kubernetes YAML部署
  • 如何从公共镜像迁移到CleanStart镜像

漏洞免责声明

CleanStart提供的Docker镜像包含由独立贡献者维护的松耦合第三方开源库和包。尽管CleanStart维护这些镜像并应用行业标准安全实践，但无法保证其控制范围之外的上游组件的安全性或完整性。

用户承认并同意，开源软件可能包含未发现的漏洞，或通过更新引入新风险。CleanStart对源自第三方库的安全问题（包括但不限于零日漏洞、供应链***或贡献者引入的风险）不承担责任。

安全是共同责任：CleanStart在可能的情况下提供更新的镜像和指导，而用户负责评估部署并实施适当的控制。