axosyslog-metrics-exporter

通过HTTP导出Axosyslog的prometheus stats。

关于

Axosyslog-metrics-exporter通过HTTP接口（默认http://0.0.0.0:9577/metrics）提供Prometheus指标。
它需要对AxoSyslog/syslog-ng™的控制套接字具有UNIX文件级访问权限，该套接字通常位于/var/lib/syslog-ng/syslog-ng.ctl或/var/run/syslog-ng/syslog-ng.ctl）。
在容器环境中，您需要通过共享卷或其他方式提供对该UNIX域套接字的访问。

HTTP和命令行界面与https://github.com/kube-logging/syslog_ng_exporter%E5%85%BC%E5%AE%B9%EF%BC%8C%E4%BD%86%E6%88%91%E4%BB%AC%E4%BD%BF%E7%94%A8AxoSyslog%E5%92%8Csyslog-ng%E2%84%A2 4.1版本及以上中提供的新原生prometheus stats。对于较旧的syslog-ng™版本，我们仍会从传统的stats接口进行转换。

用法

命令行

axosyslog-metrics-exporter [options]

选项:
-service.port string
    服务绑定端口（默认值为"9577"或$SERVICE_PORT）
-service.timeout string
    请求超时时间（默认值为"5s"或$SERVICE_TIMEOUT）
-socket.path string
    syslog-ng控制套接字路径（默认值为"/var/run/syslog-ng/syslog-ng.ctl"或$CONTROL_SOCKET）

Docker

docker run -d -p 9577:9577 -v $(echo /var/*/syslog-ng/syslog-ng.ctl):/syslog-ng.ctl \
ghcr.io/axoflow/axosyslog-metrics-exporter:latest --socket.path=/syslog-ng.ctl

Logging-operator

只需开启metrics，让https://github.com/kube-logging/logging-operator%E5%92%8CPrometheus Operator负责暴露和收集AxoSyslog指标。例如：

apiVersion: logging.banzaicloud.io/v1beta1
kind: Logging
metadata:
  name: my-logging
spec:
  controlNamespace: logging-operator
  loggingRef: my-logging
  syslogNG:
    globalOptions:
      stats:
        freq: 0 # 禁用定期将统计信息作为日志消息输出
        level: 2 # 暴露更详细的统计信息
      metrics: # 设置为{}或自定义
    serviceMonitor: true # 部署ServiceMonitor资源

您可以通过扩展Logging资源替换exporter边车容器的镜像：

apiVersion: logging.banzaicloud.io/v1beta1
kind: Logging
metadata:
  name: my-logging
spec:
  #...
  syslogNG:
    statefulSet:
      spec:
        template:
          spec:
            containers:
            - image: ghcr.io/axoflow/axosyslog-metrics-exporter:latest
              name: exporter

Axoflow

AxoSyslog Metrics Exporter是Axoflow平台的组成部分：它由Axolet代理使用，该代理负责管理和监控现有的AxoSyslog/syslog-ng™服务以及AxoRouter。申请沙箱环境或了解更多。

联系与支持

如果您需要帮助或想联系我们，请提交https://github.com/axoflow/axosyslog-metrics-exporter/issues%EF%BC%8C%E6%88%96%E5%8A%A0%E5%85%A5Axoflow ***服务器的syslog-ng频道与我们交流。

贡献

如果您修复了某个bug，或希望为这些镜像贡献改进，请https://github.com/axoflow/axosyslog-metrics-exporter/pulls%E3%80%82%E6%88%91%E4%BB%AC%E9%9D%9E%E5%B8%B8%E6%84%9F%E8%B0%A2%E6%82%A8%E7%9A%84%E5%B8%AE%E5%8A%A9%E3%80%82

关于Axoflow

要了解更多关于我们的产品和开源项目，请访问Axoflow博客，或订阅Axoflow newsletter。

syslog-ng是One Identity的商标。