community.general.logentries 回调 – 发送事件到 Logentries

注意

这个回调插件是 community.general 集合（版本 10.1.0）的一部分。

如果你正在使用 ansible 包，你可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。你需要进一步的要求才能使用此回调插件，请参阅要求了解详细信息。

要在剧本中使用它，请指定：community.general.logentries。

回调插件 

此插件是一个**通知回调**。它将剧本运行的信息发送到其他应用程序、服务或系统。有关回调插件的更多信息，请参阅回调插件。

概要 

此回调插件将生成 JSON 对象并通过 TCP 将它们发送到 Logentries，以用于审计/调试目的。
在 2.4 之前，如果要使用 ini 配置，该文件必须放在与此插件相同的目录中，并命名为 logentries.ini。
在 2.4 及更高版本中，您可以直接将其放入主 Ansible 配置文件中。

要求 

以下要求需要在执行此回调的本地控制器节点上满足。

配置中的白名单
certifi (Python 库)
flatdict (Python 库)，如果你想使用 flatten 选项

参数 

参数	注释
api 字符串	Logentries API 的 URI。默认: `"data.logentries.com"` 配置 INI 条目 [callback_logentries] api = data.logentries.com 环境变量: `LOGENTRIES_API`
flatten 布尔值	将复杂的数据结构扁平化为具有复杂键的单个字典。选择 `false` ← (默认) `true` 配置 INI 条目 [callback_logentries] flatten = false 环境变量: `LOGENTRIES_FLATTEN`
port 整数	连接到 API 时使用的 HTTP 端口。默认: `80` 配置 INI 条目 [callback_logentries] port = 80 环境变量: `LOGENTRIES_PORT`
tls_port 整数	启用 TLS 时连接到 API 使用的端口。默认: `443` 配置 INI 条目 [callback_logentries] tls_port = 443 环境变量: `LOGENTRIES_TLS_PORT`
token 字符串 / 必需	logentries `TCP 令牌`。配置 INI 条目 [callback_logentries] token = VALUE 环境变量: `LOGENTRIES_ANSIBLE_TOKEN`
use_tls 布尔值	切换以决定是否使用 TLS 加密与 API 服务器的通信。选择 `false` ← (默认) `true` 配置 INI 条目 [callback_logentries] use_tls = false 环境变量: `LOGENTRIES_USE_TLS`

示例 

examples: >
  To enable, add this to your ansible.cfg file in the defaults block

    [defaults]
    callback_whitelist = community.general.logentries

  Either set the environment variables
    export LOGENTRIES_API=data.logentries.com
    export LOGENTRIES_PORT=10000
    export LOGENTRIES_ANSIBLE_TOKEN=dd21fc88-f00a-43ff-b977-e3a4233c53af

  Or in the main Ansible config file
    [callback_logentries]
    api = data.logentries.com
    port = 10000
    tls_port = 20000
    use_tls = true
    token = dd21fc88-f00a-43ff-b977-e3a4233c53af
    flatten = false

作者

未知

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。