/appd-ansible-azure-monitor

Primary LanguageHTML

AppDynamics Azure Monitor with Ansible

This repository is intended to provide a way to install the Azure Monitor extension on a new VM using Ansible, very easily.

Requirements

  • An Azure Subscription.
  • An Azure App Registration (Azure Active Directory > App registrations > New Registration) with the Monitoring Reader role and a client secret.
  • A Virtual Machine to run the Azure Monitor extension, this guide assumes Ubuntu 18.04 in Standard B2s sizing, and assumes the azureuser + SSH PEM auth, with inbound port 22 access enabled.
  • An AppDynamics Controller.

Getting Started

  1. Copy ansible/inventory.ini.dist to ansible/inventory.ini, and set variables for your target machines.
  2. Copy ansible/variables.json.dist to ansible/variables.json, and set variables for your azure instance and configuration specifics.
  3. Run bin/ap, and watch the playbook run!

Information

  • The AppDynamics Machine Agent is installed and configured in systemd as appdynamics-machine-agent.
  • You can edit the AzureMonitor/config.yml.j2 file to your liking, including the necessary services and format.

Metrics Extension Workbench

  • If you want to use the Metrics Extension Workbench, you should allow inbound TCP through 9090 for the VM's security group.
  • To run the Metrics Extension Workbench, head into the VM and run it with sudo from /opt/appdynamics/machine-agent/run-extensions-workbench.sh, this will start the servlet on 9090 and allow you to see the metrics at the extension level, before it is sent to the controller.

Links