community.general.loganalytics callback – Posts task results to Azure Log Analytics

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.loganalytics.

New in community.general 2.4.0

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 post task results in JSON formatted to an Azure Log Analytics workspace.

  • Credits to authors of splunk callback plugin.

Requirements

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

  • Whitelisting this callback plugin.

  • An Azure log analytics work space has been established.

Parameters

Parameter

Comments

shared_key

string / required

Shared key to connect to Azure log analytics workspace.

Configuration:

workspace_id

string / required

Workspace ID of the Azure log analytics workspace.

Configuration:

  • INI entry:

    [callback_loganalytics]
workspace_id = VALUE

  • Environment variable: WORKSPACE_ID

Examples

examples: |
  Whitelist the plugin in ansible.cfg:
    [defaults]
    callback_whitelist = community.general.loganalytics
  Set the environment variable:
    export WORKSPACE_ID=01234567-0123-0123-0123-01234567890a
    export WORKSPACE_SHARED_KEY=dZD0kCbKl3ehZG6LHFMuhtE0yHiFCmetzFMc2u+roXIUQuatqU924SsAAAAPemhjbGlAemhjbGktTUJQAQIDBA==
  Or configure the plugin in ansible.cfg in the callback_loganalytics block:
    [callback_loganalytics]
    workspace_id = 01234567-0123-0123-0123-01234567890a
    shared_key = dZD0kCbKl3ehZG6LHFMuhtE0yHiFCmetzFMc2u+roXIUQuatqU924SsAAAAPemhjbGlAemhjbGktTUJQAQIDBA==

Authors

  • Cyrus Li (@zhcli)

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.