instana.instana-agent-ansible

:warning: :warning: :warning:

This repository provides a guide on how to automatically install and configure the Instana agent using Ansible. It's meant for others to copy and improve. Please note that it is not actively updated. If you've added new features to your copy that could help others, let us know so we can reference it 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 on Ansible Galaxy at https://galaxy.ansible.com/instana/instana-agent-ansible.

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

Here’s an example of a playbook with different 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

Types of Agents

instana-agent-dynamic

This is a flexible agent that includes a JDK and is set up to download all needed sensors when it starts. It also updates its sensors daily.

instana-agent-static

This version is designed not to connect to the internet at all. It comes with all the latest sensors and a JDK, making it suitable for environments with strict firewalls.

Monitoring Endpoint

If you’re a customer using on-premises solutions, please enter your hostname and port in the specified fields. For those using our SaaS, and if you're unsure which endpoint the agent should use, feel free to ask our sales team.