community.general.logentries – Sends events to Logentries

Note

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

To install it use: ansible-galaxy collection install community.general.

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

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	Choices/Defaults	Configuration	Comments
api string	Default: "data.logentries.com"	ini entries: [callback_logentries] api = data.logentries.com env:LOGENTRIES_API	URI to the Logentries API
flatten boolean	Choices: no ← yes	ini entries: [callback_logentries] flatten = no env:LOGENTRIES_FLATTEN	flatten complex data structures into a single dictionary with complex keys
port string	Default: 80	ini entries: [callback_logentries] port = 80 env:LOGENTRIES_PORT	HTTP port to use when connecting to the API
tls_port string	Default: 443	ini entries: [callback_logentries] tls_port = 443 env:LOGENTRIES_TLS_PORT	Port to use when connecting to the API when TLS is enabled
token string / required		ini entries: [callback_logentries] token = None env:LOGENTRIES_ANSIBLE_TOKEN	The logentries "TCP token"
use_tls boolean	Choices: no ← yes	ini entries: [callback_logentries] use_tls = no env:LOGENTRIES_USE_TLS	Toggle to decide whether to use TLS to encrypt the communications with the API server

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 = no
    token = dd21fc88-f00a-43ff-b977-e3a4233c53af
    flatten = False

Authors

• Unknown (!UNKNOWN)