如何通过Google Cloud Ops Agent将日志文件名作为Google Logging中的日志名称？

要让Google Logging中清晰区分不同站点的Nginx访问日志，结合你有数百个日志文件的场景，推荐下面两种方案：

方案1：添加文件名作为日志标签（推荐） #

这种方法无需为每个文件单独配置接收器，通过Ops Agent的日志处理器把文件名添加为日志标签，既能统一管理配置，又能在控制台轻松筛选不同站点的日志。

修改你的google-cloud-ops-agent/config.yaml配置如下：

logging:
  receivers:
    nginx_access:
      type: nginx_access
    nginx_error:
      type: nginx_error
    nginx_access_files:
      type: files
      include_paths: [/var/log/nginx/*access*.log]
      # 显式开启记录日志文件路径（默认可能已启用，显式设置更稳妥）
      record_log_file_path: true
  # 新增处理器：从文件路径中提取文件名并添加为标签
  processors:
    add_filename_label:
      type: modify_fields
      fields:
        labels:
          add:
            # 用Go模板语法从完整路径中提取纯文件名
            log_filename: "{{ split(sourceLocation.file, '/')[-1] }}"
  service:
    pipelines:
      nginx:
        receivers:
          - nginx_access
          - nginx_error
          - nginx_access_files
        processors:
          - add_filename_label
metrics:
  receivers:
    nginx:
      type: nginx
      stub_status_url: http://127.0.0.1:80/status
  service:
    pipelines:
      nginx:
        receivers:
          - nginx

配置说明： #

• record_log_file_path: true：确保Ops Agent将日志文件的完整路径写入日志条目的sourceLocation.file字段。
• add_filename_label处理器：通过模板语法截取路径中的最后一段（即文件名），添加到日志的labels.log_filename标签中。

配置完成后重启Ops Agent生效：

sudo systemctl restart google-cloud-ops-agent

在Google Logging控制台，你可以：

• 用labels.log_filename="site1_access.log"这样的查询语句快速筛选特定站点的日志；
• 创建自定义日志视图，按log_filename分组展示不同站点的日志数据。

方案2：为每个日志文件单独配置接收器（适合少量文件） #

如果你的日志文件数量不多，可以为每个站点的日志创建独立接收器，这样每个接收器会对应一个专属的logName（比如projects/你的项目ID/logs/nginx_access_site1）。

示例配置片段：

logging:
  receivers:
    nginx_access:
      type: nginx_access
    nginx_error:
      type: nginx_error
    # 为site1的日志创建独立接收器
    nginx_access_site1:
      type: files
      include_paths: [/var/log/nginx/site1_access.log]
    # 为site2的日志创建独立接收器
    nginx_access_site2:
      type: files
      include_paths: [/var/log/nginx/site2_access.log]
    # 继续添加其他站点的接收器...
  service:
    pipelines:
      nginx:
        receivers:
          - nginx_access
          - nginx_error
          - nginx_access_site1
          - nginx_access_site2
          # 追加其他接收器...
metrics:
  receivers:
    nginx:
      type: nginx
      stub_status_url: http://127.0.0.1:80/status
  service:
    pipelines:
      nginx:
        receivers:
          - nginx

但这种方法在有数百个文件时会让配置文件极度冗长，维护成本很高，因此仅推荐用于文件数量较少的场景。

补充：为什么默认Nginx错误日志能区分？ #

默认的nginx_error接收器是针对Nginx错误日志格式优化的，它会自动识别标准路径的错误日志。实际上它也会统一使用nginx_error作为logName，但你可以通过sourceLocation.file字段查看具体来源文件。你想要的“按文件名显示日志名称”本质是每个文件对应独立的logName，这只能通过单独配置接收器实现，但显然不适合数百个文件的场景，因此方案1是更优解。

内容的提问来源于stack exchange，提问作者Timo77