community.general.logentries callback – Sends events to Logentries

Note

This callback plugin is part of the community.general collection (version 9.4.0).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general. You need further requirements to be able to use this callback plugin, see Requirements for details.

To use it in a playbook, specify: community.general.logentries.

Callback plugin

This plugin is a notification callback. It sends information for a playbook run to other applications, services, or systems. See Callback plugins for more information on callback plugins.

Synopsis

  • This callback plugin will generate JSON objects and send them to Logentries via TCP for auditing/debugging purposes.

  • Before 2.4, if you wanted to use an ini configuration, the file must be placed in the same directory as this plugin and named logentries.ini.

  • In 2.4 and above you can just put it in the main Ansible configuration file.

Requirements

The below requirements are needed on the local controller node that executes this callback.

  • whitelisting in configuration

  • certifi (Python library)

  • flatdict (Python library), if you want to use the flatten option

Parameters

Parameter

Comments

api

string

URI to the Logentries API.

Default: "data.logentries.com"

Configuration:

  • INI entry:

    [callback_logentries]
api = data.logentries.com

  • Environment variable: LOGENTRIES_API

flatten

boolean

Flatten complex data structures into a single dictionary with complex keys.

Choices:

  • false ← (default)

  • true

Configuration:

  • INI entry:

    [callback_logentries]
flatten = false

  • Environment variable: LOGENTRIES_FLATTEN

port

integer

HTTP port to use when connecting to the API.

Default: 80

Configuration:

  • INI entry:

    [callback_logentries]
port = 80

  • Environment variable: LOGENTRIES_PORT

tls_port

integer

Port to use when connecting to the API when TLS is enabled.

Default: 443

Configuration:

token

string / required

The logentries TCP token.

Configuration:

use_tls

boolean

Toggle to decide whether to use TLS to encrypt the communications with the API server.

Choices:

  • false ← (default)

  • true

Configuration:

  • INI entry:

    [callback_logentries]
use_tls = false

  • Environment variable: LOGENTRIES_USE_TLS

Examples

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

Authors

  • Unknown

Hint

Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.