instana-agent-ansible

:warning: :warning: :warning:

This repository is a blueprint to show how the Instana agent installation and configuration can be automated with Ansible and is intended for others to fork and build upon. It is not actively maintained. If you have introduce new functionality on your fork that you think is useful for others, get in touch so we can link to it from here.

:warning: :warning: :warning:

instana-agent-ansible role

The Ansible role installs, configures and runs the monitoring agent for the Instana monitoring suite. You can find the role in the Ansible galaxy at https://galaxy.ansible.com/instana/instana-agent-ansible.

To install the role use ansible-galaxy install instana.instana-agent-ansible.

Here is an example of a playbook with the various configuration options:

Example:

---
  - hosts: all
    become: yes
    roles:
      - instana.instana-agent-ansible
    vars:
      instana_agent_flavor: "dynamic"
      instana_agent_jdk: "/opt/jdk"
      instana_agent_updates_enabled: yes
      instana_agent_updates_interval: "DAY"
      instana_agent_updates_time: "04:30"
      instana_agent_zone: "prod"
      instana_agent_agent_key: <YOUR_INSTANA_AGENT_KEY>
      instana_agent_endpoint_host: <YOUR_INSTANA_REGION_ENDPOINT:saas-us-west-2.instana.io>
      instana_agent_endpoint_port: 443

Flavors

instana-agent-dynamic

This blank agent comes bundled with a JDK and is configured to download all neccessary sensors when it starts. Additionally, it is configured to update its set of sensors on a daily basis.

instana-agent-static

This "gated" agent package is supposed to not connect to the internet at all. It comes with all the recent sensors and a JDK, and is your package of choice when you run a tight firewall setup.

Monitoring endpoint

If you're an onprem customer, please specify your hostname and port in the corresponding attributes. If you're using our SaaS offering, and don't know which endpoint the agent should send to, feel free to ask our sales team.