›

开始使用

步骤 1：安装

将包添加到您的 go.mod 文件中

require go.elastic.co/ecszerolog main

步骤 2：配置

编辑

设置一个默认的日志记录器。例如

logger := ecszerolog.New(os.Stdout)
log.Logger = logger

示例

编辑

使用结构化日志

编辑

// Add custom fields.
log.Info().Msg("hello world").Str("custom", "foo")

上面的示例会生成以下日志输出

{
  "@timestamp": "2021-01-20T11:12:43.061+0800",
  "custom":"foo",
  "ecs.version": "1.6.0",
  "log.level": "info",
  "message":"hello world"
}

步骤 3：配置 Filebeat

编辑

按照 Filebeat 快速入门
将以下配置添加到您的 filebeat.yaml 文件中。

对于 Filebeat 7.16+

filebeat.yaml。

filebeat.inputs:
- type: filestream 
  paths: /path/to/logs.json
  parsers:
    - ndjson:
      overwrite_keys: true 
      add_error_key: true 
      expand_keys: true 

processors: 
  - add_host_metadata: ~
  - add_cloud_metadata: ~
  - add_docker_metadata: ~
  - add_kubernetes_metadata: ~

	使用 filestream 输入从活动的日志文件中读取行。
	如果发生冲突，解码后的 JSON 对象中的值将覆盖 Filebeat 通常添加的字段（类型、来源、偏移量等）。
	如果发生 JSON 反序列化错误，Filebeat 会添加 "error.message" 和 "error.type: json" 键。
	Filebeat 将递归地删除解码后的 JSON 中的键的点号，并将它们展开为分层对象结构。
	处理器可以增强您的数据。请参阅处理器以了解更多信息。

对于 Filebeat < 7.16

filebeat.yaml。

filebeat.inputs:
- type: log
  paths: /path/to/logs.json
  json.keys_under_root: true
  json.overwrite_keys: true
  json.add_error_key: true
  json.expand_keys: true

processors:
- add_host_metadata: ~
- add_cloud_metadata: ~
- add_docker_metadata: ~
- add_kubernetes_metadata: ~

确保您的应用程序将日志记录到 stdout/stderr。
按照在 Kubernetes 上运行 Filebeat 指南。
启用基于提示的自动发现（取消注释 filebeat-kubernetes.yaml 中的相应部分）。
将这些注释添加到使用 ECS 日志记录器的 Pod 中。这将确保日志被正确解析。

annotations:
  co.elastic.logs/json.overwrite_keys: true 
  co.elastic.logs/json.add_error_key: true 
  co.elastic.logs/json.expand_keys: true

	如果发生冲突，解码后的 JSON 对象中的值将覆盖 Filebeat 通常添加的字段（类型、来源、偏移量等）。
	如果发生 JSON 反序列化错误，Filebeat 会添加 "error.message" 和 "error.type: json" 键。
	Filebeat 将递归地删除解码后的 JSON 中的键的点号，并将它们展开为分层对象结构。

确保您的应用程序将日志记录到 stdout/stderr。
按照在 Docker 上运行 Filebeat 指南。
启用基于提示的自动发现。
将这些标签添加到使用 ECS 日志记录器的容器中。这将确保日志被正确解析。

docker-compose.yml。

labels:
  co.elastic.logs/json.overwrite_keys: true 
  co.elastic.logs/json.add_error_key: true 
  co.elastic.logs/json.expand_keys: true

	如果发生冲突，解码后的 JSON 对象中的值将覆盖 Filebeat 通常添加的字段（类型、来源、偏移量等）。
	如果发生 JSON 反序列化错误，Filebeat 会添加 "error.message" 和 "error.type: json" 键。
	Filebeat 将递归地删除解码后的 JSON 中的键的点号，并将它们展开为分层对象结构。

有关更多信息，请参阅 Filebeat 参考。

« 简介