11. Tower 日志记录和聚合¶

11.1.1. 日志消息模式¶

所有记录器的通用模式

• cluster_host_id: Tower 集群中主机的唯一标识符

• level: 标准 python 日志级别，大致反映事件的重要性 所有作为此功能一部分的数据记录器都使用 INFO 级别，但其他 Tower 日志将根据需要使用不同的级别

• logger_name: 我们在设置中使用的记录器名称，例如“activity_stream”

• @timestamp: 日志时间

• path: 生成日志的代码中的文件路径

11.1.2. 活动流模式¶

• (通用): 这使用了上面列出的所有记录器共有的所有字段

• actor: 执行日志记录操作的用户的用户名

• changes: 对更改的字段及其旧/新值的 JSON 摘要。

• operation: 活动流中记录的更改的基本类别，例如，“关联”。

• object1: 有关正在操作的主要对象的信息，与我们在活动流中显示的信息一致

• object2: 如果适用，则为操作中涉及的第二个对象

11.1.3. 作业事件模式¶

此记录器反映了保存到作业事件中的数据，除非它们与记录器预期标准字段发生冲突，在这种情况下，字段将被嵌套。值得注意的是，job_event 模型上的字段主机被指定为 event_host。在有效负载中还有一个子字典字段 event_data，其中包含根据 Ansible 事件的具体情况而不同的不同字段。

此记录器还包含通用字段。

11.1.4. 扫描/事实/系统跟踪数据模式¶

这些包含详细的字典类型字段，这些字段是服务、软件包或文件。

• (通用): 这使用了上面列出的所有记录器共有的所有字段

• services: 对于服务扫描，此字段包含在内，并具有基于服务名称的键。**注意**: Elasticsearch 不允许名称中使用句点，并且我们的日志格式化程序会将句点替换为“_”

• package: 包含在来自软件包扫描的日志消息中

• files: 包含在来自文件扫描的日志消息中

• host: 扫描适用的主机名称

• inventory_id: 主机所在的清单 ID

11.1.5. 作业状态更改¶

这旨在成为关于作业状态更改的信息的低容量来源，与作业事件相比，它还旨在捕获除基于作业模板的作业之外的统一作业类型的更改。

除了通用字段外，这些日志还包含作业模型中存在的字段。

11.1.6. Tower 日志¶

除了通用字段外，这还包含一个 msg 字段，其中包含日志消息。错误包含一个单独的 traceback 字段。这些日志可以在配置 Tower 用户界面 ENABLE EXTERNAL LOGGING 设置中启用或禁用。

11.1.7. 日志聚合器服务¶

日志聚合器服务与以下监控和数据分析系统配合使用

11.1.7.1. Splunk¶

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

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 文档。

11.1.7.2. Loggly¶

要设置通过 Loggly 的 HTTP 端点发送日志，请参阅https://www.loggly.com/docs/http-endpoint/。Loggly 使用在http://logs-01.loggly.com/inputs/TOKEN/tag/http/中描述的 URL 约定，该约定在以下示例中显示在**日志记录聚合器**字段中输入

11.1.7.3. Sumologic¶

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