omsagent

This role is no longer active, and the last version has started to face issues.

Install Microsoft omsagent (Log Analytics agent) on your system.

GitHub	GitLab	Quality	Downloads	Version

Example Playbook

This example comes from molecule/default/converge.yml and is tested with every update, pull request, and release.

---
- name: converge
  hosts: all
  become: yes
  gather_facts: yes

  roles:
    - role: robertdebock.omsagent

The machine needs preparation. In CI, this is done using molecule/default/prepare.yml:

---
- name: prepare
  hosts: all
  become: yes
  gather_facts: no

  roles:
    - role: robertdebock.bootstrap
    - role: robertdebock.core_dependencies
    - role: robertdebock.users
      users_group_list:
        - name: omiusers
      users_user_list:
        - name: omsagent
          group: omiusers
    - role: robertdebock.auditd
      auditd_local_events: "no"
    - role: robertdebock.cron

For more information, check this full explanation and example on how to use these roles.

Role Variables

Default values for the variables are in defaults/main.yml:

---
# defaults file for omsagent

# More documentation on the Log Analytic Agent can be found at:
# https://docs.microsoft.com/en-us/azure/azure-monitor/platfrom/logs-analytics-agent

omsagent_version: "1.13.40-0"

# The omsagent_tmp directory is where the installer script is stored.
# The installer downloads a large file (125MB) to this directory.
omsagent_tmp: /tmp

# User and group owning the directory.
omsagent_owner: omsagent
omsagent_group: omiusers

# Use this as the OMS domain for setup.
# For Azure monitoring log Analytics workspace in Government cloud use:
# omsagent_domain: opinsights.azure.command
# Leave empty to use default (omsagent_domain: opinsights.azure.com).
omsagent_domain: ""

# Use [protocol://][user:password@]proxyhost[:port] for proxy configuration.
# omsagent_proxy: "https://username:password@proxyserver:proxyport"

Requirements

• pip packages listed in requirements.txt.

Status of used roles

The following roles are used to set up a system. You can choose a different method if you prefer.

Requirement	GitHub	GitLab
robertdebock.auditd
robertdebock.bootstrap
robertdebock.core_dependencies
robertdebock.cron
robertdebock.users

Context

This role is part of many compatible roles. For more information, see the documentation of these roles.

Here is an overview of related roles:

Compatibility

This role has been tested on these container images:

You need at least Ansible version 2.10. Tests have also been done on:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub

License

Apache-2.0

Author Information

Robert de Bock

Please consider sponsoring me.