logdna.logdna

使用 Ansible 部署 LogDNA Agent

Ansible Galaxy 角色用于安装和配置 LogDNA Agent。

agent_install：如果要安装则为 true（默认值：true）
agent_config：如果要配置则为 true（默认值：true）
agent_service：（默认值：started），支持：
- started：如果指定了 conf_key，则启动 LogDNA Agent 服务
- restarted：重启 LogDNA Agent 服务
- stopped：停止 LogDNA Agent 服务。

这些变量与 LogDNA Agent 的本地配置选项直接对应：

从 Ansible Galaxy 在线安装：ansible-galaxy install logdna.logdna
从源代码直接安装：ansible-galaxy install git+https://github.com/logdna/ansible-logdna.git

- hosts: <hosts>
  vars:
    conf_key: <LogDNA 采集密钥>
  roles:
     - { role: logdna.logdna }

- hosts: <hosts>
  vars:
    conf_key: <LogDNA 采集密钥>
    # 所有其他配置参数的说明
  roles:
     - { role: logdna.logdna }

- hosts: <hosts>
  vars:
    # 重新配置的参数说明
    agent_service: restarted
  roles:
     - { role: logdna.logdna }

- hosts: <hosts>
  vars:
    # 不设置 LogDNA 采集密钥
    agent_config: false
  roles:
     - { role: logdna.logdna }

- hosts: <hosts>
  vars:
    agent_install: false
    agent_config: false
    agent_service: stopped
  roles:
     - { role: logdna.logdna }

LogDNA 回调插件是一个处理程序，用于将每次 ansible-playbook 运行中的日志发送到 LogDNA。目前支持以下类别的日志：STATS、FAILED、OK、UNREACHABLE、ASYNC_FAILED、ASYNC_OK。可以通过以下方式配置：

如果未安装 LogDNA Agent Python 包，请根据您使用的 Python 版本使用以下命令之一进行安装：pip install logdna 或 pip3 install logdna
如果您使用的 Ansible 版本低于 v2.6（即 <= v2.5），请进行以下步骤：
- 从这里下载插件到回调插件文件夹。可以通过以下命令找到该文件夹： echo $(ansible-doc -F | awk 'FNR == 1 {print $2}' | sed 's/\/modules/+/g' | cut -d'+' -f 1)/plugins/callback
如果您的系统上没有 ansible.cfg，请按以下步骤操作：
- 通过 mkdir -p /etc/ansible 确保 /etc/ansible 文件夹存在
- 从这里下载 ansible.cfg 到 /etc/ansible/
执行 ANSIBLE_CONFIG=< ansible.cfg 的路径 >
打开 ansible.cfg 并进行以下步骤：
- 如果被注释，请取消注释包含 callback_whitelist 的行，并附加 logdna
- 如果被注释，请取消注释包含 callback_plugins 的行，并更新回调插件的路径
为了使插件工作，以下环境变量应设置：
- LOGDNA_INGESTION_KEY：用于流式传输日志的 LogDNA 采集密钥 - 必需
- ANSIBLE_IGNORE_ERRORS：是否在失败时忽略错误；默认为 False - 可选
- LOGDNA_HOSTNAME：在日志中使用的替代主机名 - 可选
- LOGDNA_TAGS：以逗号分隔的标签列表；默认为 ansible - 可选