为指标配置 HTTP 端点编辑

此功能处于技术预览阶段,可能会在未来版本中更改或删除。Elastic 将努力解决任何问题,但技术预览版中的功能不受官方 GA 功能的支持 SLA 的约束。

Auditbeat 可以通过 HTTP 端点公开内部指标。这些指标对于监控 Beat 的内部状态非常有用。出于安全原因,默认情况下该端点处于禁用状态,因为您可能希望避免公开此信息。

HTTP 端点具有以下配置设置

http.enabled
(可选)启用 HTTP 端点。默认为 false
http.host
(可选)绑定到此主机名、IP 地址、Unix 套接字 (unix:///var/run/auditbeat.sock) 或 Windows 命名管道 (npipe:///auditbeat)。建议仅使用 localhost。默认为 localhost
http.port
(可选)HTTP 端点将绑定到的端口。默认为 5066
http.named_pipe.user
(可选) 用于创建命名管道的用户,仅适用于 Windows,默认为当前用户。
http.named_pipe.security_descriptor
(可选) 以 SDDL 格式定义的 Windows 安全描述符字符串。默认为当前用户的读写权限。
http.pprof.enabled
(可选)在提供 HTTP 服务时启用 /debug/pprof/ 端点。建议仅在 localhost 上启用此功能,因为这些端点可能会泄露数据。默认为 false
http.pprof.block_profile_rate
(可选)block_profile_rate 控制在 /debug/pprof/block 提供的阻塞配置文件中报告的 goroutine 阻塞事件的比例。分析器旨在对阻塞花费的每纳秒速率平均采样一个阻塞事件。要在配置文件中包含每个阻塞事件,请传递 rate = 1。要完全关闭分析,请传递 rate ⇐ 0。默认为 0。
http.pprof.mem_profile_rate
(可选)mem_profile_rate 控制在 /debug/pprof/heap 提供的内存配置文件中记录和报告的内存分配的比例。分析器旨在对分配的每 mem_profile_rate 字节平均采样一个分配。要在配置文件中包含每个分配的块,请将 mem_profile_rate 设置为 1。要完全关闭分析,请将 mem_profile_rate 设置为 0。默认为 524288。
http.pprof.mutex_profile_rate
(可选)mutex_profile_rate 控制在 /debug/pprof/mutex 提供的互斥量配置文件中报告的互斥量争用事件的比例。平均报告 1/rate 个事件。要完全关闭分析,请传递 rate 0。默认值为 0。

这是您可以访问的路径列表。对于漂亮的 JSON 输出,请将 ?pretty 附加到 URL。

您可以使用 cURL 命令和 --unix-socket 标志查询 Unix 套接字。

curl -XGET --unix-socket '/var/run/{beatname_lc}.sock' 'http:/stats/?pretty'

信息编辑

/ 提供来自 Auditbeat 的基本信息。例子

curl -XGET 'localhost:5066/?pretty'
{
  "beat": "auditbeat",
  "hostname": "example.lan",
  "name": "example.lan",
  "uuid": "34f6c6e1-45a8-4b12-9125-11b3e6e89866",
  "version": "8.14.3"
}

统计编辑

/stats 报告内部指标。例子

curl -XGET 'localhost:5066/stats?pretty'
{
  "beat": {
    "cpu": {
      "system": {
        "ticks": 1710,
        "time": {
          "ms": 1712
        }
      },
      "total": {
        "ticks": 3420,
        "time": {
          "ms": 3424
        },
        "value": 3420
      },
      "user": {
        "ticks": 1710,
        "time": {
          "ms": 1712
        }
      }
    },
    "info": {
      "ephemeral_id": "ab4287c4-d907-4d9d-b074-d8c3cec4a577",
      "uptime": {
        "ms": 195547
      }
    },
    "memstats": {
      "gc_next": 17855152,
      "memory_alloc": 9433384,
      "memory_total": 492478864,
      "rss": 50405376
    },
    "runtime": {
      "goroutines": 22
    }
  },
  "libbeat": {
    "config": {
      "module": {
        "running": 0,
        "starts": 0,
        "stops": 0
      },
      "scans": 1,
      "reloads": 1
    },
    "output": {
      "events": {
        "acked": 0,
        "active": 0,
        "batches": 0,
        "dropped": 0,
        "duplicates": 0,
        "failed": 0,
        "total": 0
      },
      "read": {
        "bytes": 0,
        "errors": 0
      },
      "type": "elasticsearch",
      "write": {
        "bytes": 0,
        "errors": 0
      }
    },
    "pipeline": {
      "clients": 6,
      "events": {
        "active": 716,
        "dropped": 0,
        "failed": 0,
        "filtered": 0,
        "published": 716,
        "retry": 278,
        "total": 716
      },
      "queue": {
        "acked": 0
      }
    }
  },
  "system": {
    "cpu": {
      "cores": 4
    },
    "load": {
      "1": 2.22,
      "15": 1.8,
      "5": 1.74,
      "norm": {
        "1": 0.555,
        "15": 0.45,
        "5": 0.435
      }
    }
  }
}

实际输出可能包含更多特定于 Auditbeat 的指标