收集 NGINX 日志

此 NGINX 解析器可处理 JSON 和 syslog 格式的日志。它会从各种日志格式中提取字段，并将其标准化为 UDM 格式。解析器会使用服务器管理和网络活动（包括用户登录和 HTTP 请求）的元数据来丰富事件。它还会处理 SSH 事件的逻辑，并根据提取的数据填充 UDM 字段。

准备工作

确保您满足以下前提条件：

• Google SecOps 实例
• NGINX 正在运行并生成日志
• 对 NGINX 宿主机的 root 访问权限

获取 Google SecOps 提取身份验证文件

1. 登录 Google SecOps 控制台。
2. 依次前往 SIEM 设置 > 收集代理。
3. 下载提取身份验证文件。将该文件安全地保存在将安装 BindPlane 的系统上。

获取 Google SecOps 客户 ID

1. 登录 Google SecOps 控制台。
2. 依次选择 SIEM 设置 > 配置文件。
3. 复制并保存组织详细信息部分中的客户 ID。

安装 Bindplane 代理

Windows 安装

1. 以管理员身份打开命令提示符或 PowerShell。

2. 运行以下命令：

   msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quiet
   

Linux 安装

1. 打开具有 root 或 sudo 权限的终端。

2. 运行以下命令：

   sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.sh
   

其他安装资源

• 如需了解其他安装选项，请参阅此安装指南。

配置 Bindplane 代理以注入 Syslog 并将其发送到 Google SecOps

1. 访问配置文件：

   1. 找到 config.yaml 文件。通常，在 Linux 上，该目录位于 /etc/bindplane-agent/ 目录中；在 Windows 上，该目录位于安装目录中。
   2. 使用文本编辑器（例如 nano、vi 或记事本）打开该文件。

2. 按如下方式修改 config.yaml 文件：

   receivers:
       udplog:
           # Replace the port and IP address as required
           listen_address: "0.0.0.0:514"
   
   exporters:
       chronicle/chronicle_w_labels:
           compression: gzip
           # Adjust the path to the credentials file you downloaded in Step 1
           creds: '/path/to/ingestion-authentication-file.json'
           # Replace with your actual customer ID from Step 2
           customer_id: <customer_id>
           endpoint: malachiteingestion-pa.googleapis.com
           # Add optional ingestion labels for better organization
           ingestion_labels:
               log_type: 'NGINX'
               raw_log_field: body
   
   service:
       pipelines:
           logs/source0__chronicle_w_labels-0:
               receivers:
                   - udplog
               exporters:
                   - chronicle/chronicle_w_labels
   

3. 根据基础架构中的需要替换端口和 IP 地址。

4. 将 <customer_id> 替换为实际的客户 ID。

5. 在获取 Google SecOps 提取身份验证文件部分中，将 /path/to/ingestion-authentication-file.json 更新为身份验证文件的保存路径。

重启 Bindplane 代理以应用更改

• 如需在 Linux 中重启 Bindplane 代理，请运行以下命令：

  sudo systemctl restart bindplane-agent
  

• 如需在 Windows 中重启 Bindplane 代理，您可以使用服务控制台，也可以输入以下命令：

  net stop BindPlaneAgent && net start BindPlaneAgent
  

确定 NGINX 日志文件的位置

1. 通常，NGINX 日志存储在以下位置：
   • 访问日志：/var/log/nginx/access.log
   • 错误日志：/var/log/nginx/error.log
2. 使用管理员凭据访问 NGINX 主机。

3. 运行以下命令，然后在 NGINX 主机上查找日志路径：

   sudo cat /etc/nginx/nginx.conf | grep log
   

配置 NGINX 以将日志转发到 BindPlane

1. 打开 NGINX 配置文件（例如 /etc/nginx/nginx.conf）：

   sudo vi /etc/nginx/nginx.conf
   

2. 修改配置，将 <BINDPLANE_SERVER> 和 <BINDPLANE_PORT> 替换为您的值：

   http {
       access_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_access;
       error_log syslog:server=<BINDPLANE_SERVER>:<BINDPLANE_PORT>,facility=local7,tag=nginx_error;
   }
   

3. 重启 NGINX 以应用更改：

   sudo systemctl reload nginx
   

UDM 映射表

变化

2022-09-10

• 创建了默认解析器并删除了特定于客户的解析器
• 初始解析器版本

需要更多帮助？向社区成员和 Google SecOps 专业人士寻求解答。