12. Tower 日志记录和聚合¶

12.1. 日志记录器¶

以下是特殊的日志记录器（除了 awx，它提供通用的服务器日志），它以可预测的结构或半结构格式提供大量信息，其结构与从 API 获取数据时所需的结构相同：

• job_events：提供从 Ansible 回调模块返回的数据

• activity_stream：显示 Ansible Tower 应用中对象的更改记录

• system_tracking：提供由扫描作业模板运行的 Ansible 扫描模块收集的数据

• awx：提供通用服务器日志，其中包括通常要写入文件的日志。它包含了所有日志都具有的标准元数据，除了它只有来自日志语句的消息。

这些日志记录器只使用 INFO 的日志级别，但 awx logger 除外，它可能是任意给定级别。

另外，标准的 Tower 日志可以通过同样的机制来提供。它包括如何启用或禁用这五个数据源中的每个源，而无需在本地设置文件中操作复杂的字典，以及调整标准 Tower 日志消耗的日志级别。

要在 Ansible Tower 中配置各种日志记录组件，请在左侧导航栏中的 () 菜单中选择 System。

12.1.7. 日志记录聚合器服务¶

日志记录聚合器服务用于以下监控和数据分析系统：

• Splunk

• Loggly

• Sumologic

• 弹性堆栈（以前称为 ELK 堆栈）

12.1.7.1. Splunk¶

Ansible Tower 的 Splunk 日志记录集成使用 Splunk HTTP 收集器。在配置 SPLUNK 日志记录聚合器时，将完整 URL 添加到 HTTP 事件收集器主机，如下例所示：

https://yourtowerfqdn.com/api/v2/settings/logging

{
    "LOG_AGGREGATOR_HOST": "https://yoursplunk:8088/services/collector/event",
    "LOG_AGGREGATOR_PORT": null,
    "LOG_AGGREGATOR_TYPE": "splunk",
    "LOG_AGGREGATOR_USERNAME": "",
    "LOG_AGGREGATOR_PASSWORD": "$encrypted$",
    "LOG_AGGREGATOR_LOGGERS": [
        "awx",
        "activity_stream",
        "job_events",
        "system_tracking"
    ],
    "LOG_AGGREGATOR_INDIVIDUAL_FACTS": false,
    "LOG_AGGREGATOR_ENABLED": true,
    "LOG_AGGREGATOR_TOWER_UUID": ""
}

Splunk HTTP 事件收集器默认在 8088 上侦听，因此需要提供完整的 HEC 事件 URL（附带端口），以便成功处理传入请求。这些值在以下示例中输入：

有关配置 HTTP 事件收集器的进一步说明，请参阅 Splunk documentation。

12.1.7.2. Loggly¶

要通过 Loggly 的 HTTP 端点来设置日志的发送，请参阅 https://www.loggly.com/docs/http-endpoint/. Loggly 使用 http://logs-01.loggly.com/inputs/TOKEN/tag/http/ 描述的 URL 惯例。在下例中，它已被输入到 Logging Aggregator 字段中：

12.1.7.3. Sumologic¶

在 Sumologic 中，创建一个包含 json 文件的搜索条件，该文件提供用于收集所需数据的参。

12.1.7.4. 弹性堆栈（以前称为 ELK 堆栈）¶

如果从头开始，基于您自己版本的弹性堆栈，您唯一需要的修改是将以下几行添加到 logstash logstash.conf 文件中：

filter {
  json {
    source => "message"
  }
}

注解

在 Elastic 5.0.0 中引入了向后兼容的更改，且可能需要根据所使用的版本进行不同的配置。

12.2. 使用 Tower 设置日志记录¶

将日志记录设置为任何聚合器类型：

1. 点击左侧导航栏中的 Settings () 图标。

2. 选择 System。

3. 在系统屏幕中，选择 Logging 选项卡。

4. 从提供的字段中设置可配置选项：

• Enable External Logging：如果要将日志发送到外部日志聚合器，请点击切换按钮切换到 ON。

• Logging Aggregator：输入您要发送日志的主机名或 IP 地址。

• Logging Aggregator Port：如果聚合器需要端口，请为其指定端口。

• Logging Aggregator Type：点击可从下拉菜单中选择聚合器服务：

• Logging Aggregator Username：如果需要，请输入日志聚合器的用户名。

• Logging Aggregator Password/Token：如果需要，请输入日志聚合器的密码。

• Loggers to Send Data to the Log Aggregator Form：所有四类数据都是默认预先填充。点击字段旁的工具提示 图标可查看每种数据类型的附加信息。删除您不想要的数据类型。

• Log System Tracking Facts Individually：点击工具提示 图标可查看是否要打开的附加信息，或者默认保持关闭。

• Logging Aggregator Protocol：点击选择一个连接类型（协议）与日志聚合器通信。后续选项根据所选协议的不同而有所变化。

• TCP Connection Timeout：以秒为单位指定连接超时时间。此选项仅适用于 HTTPS 和 TCP 日志聚合协议。

• Logging Aggeregator Level Threshold：选择希望日志处理器报告的严重性级别。

• Enable/Disable HTTPS Certificate Verification：HTTPS 日志协议默认启用证书验证。如果您不希望日志处理器在建立连接前验证由外部日志聚合器发送的 HTTPS 证书，请点击切换按钮切换到 OFF。

5. 检查您选择的日志记录聚合的条目。以下是为 Splunk 设置的示例：

6. 要验证您的配置是否正确设置，请点击**Test**。这可以通过发送测试日志消息并检查响应代码来验证日志配置是否正确。

7. 完成后，点击 Save 应用设置，或者点 Cancel 取消更改。