AppDynamics Monitoring Extension for use with Zabbix

This extension works only with the standalone machine agent.

 

Use Case

Zabbix is the ultimate enterprise-level software designed for monitoring availability and performance of IT infrastructure components. Zabbix is open source and comes at no cost.

 

Pre-requisites

  1. Before the extension is installed, the prerequisites mentioned here need to be met. Please do not proceed with the extension installation if the specified prerequisites are not met.

Installation

  1. Download and unzip the file 'ZabbixMonitor.zip' to <machineagent install dir>/monitors
  2. Open monitor.xml and configure yml path
  3. Open config.yml and configure the zabbix details

The metricPrefix of the extension has to be configured as specified here. Please make sure that the right metricPrefix is chosen based on your machine agent deployment, otherwise this could lead to metrics not being visible in the controller.

monitor.xml

<argument name="config-file" is-required="true" default-value=""monitors/ZabbixMonitor/config.yml" />

config.yml

# Zabbix particulars
protocol: "http"
host: ""
port:
username: ""
password: ""
jsonRpcPath: "api_jsonrpc.php"

#Include Exclude Hosts. Include takes precedence over exclude.
includeHosts: []
excludeHosts: []

#Provide either includeItems or excludeItems
#Only matched items will be included from the hosts after applying includeHosts/excludeHosts
includeItems: []

#Matched items will be excluded from the hosts after applying includeHosts/excludeHosts
excludeItems: []

#Replaces characters in metric name with the specified characters.
# "replace" takes any regular expression
# "replaceWith" takes the string to replace the matched characters
metricCharacterReplacer:
   - replace: ","
     replaceWith: ";"

#This will create this metric in all the tiers, under this path
#metricPathPrefix: Custom Metrics|Zabbix|

#This will create it in specific Tier/Component. Make sure to replace {COMPONENT_ID} with the appropriate one from your environment.
#To find the {COMPONENT_ID} in your environment, please follow the screenshot https://docs.appdynamics.com/display/PRO42/Build+a+Monitoring+Extension+Using+Java
metricPathPrefix: Server|Component:{COMPONENT_ID}|Custom Metrics|Zabbix|

Metrics

The following metrics are reported.

 

ITService

All the IT Services configured will be shown here

Metric Path
Zabbix/ITService/{IT Service Name}

 

History

All the historic stats gathered by zabbix will be shown here

Metric Path
Zabbix/History/{Host ID}/Outgoing network traffic on eth0
Zabbix/History/{Host ID}/Maximum number of opened files
Zabbix/History/{Host ID}/Total swap space
Zabbix/History/{Host ID}/Number of processes
Zabbix/History/{Host ID}/Context switches per second
Zabbix/History/{Host ID}/Free swap space
Zabbix/History/{Host ID}/Host local time
Zabbix/History/{Host ID}/Zabbix queue
Zabbix/History/{Host ID}/Free disk space on /etc/resolv.conf
Zabbix/History/{Host ID}/Used disk space on /etc/Zabbix/Zabbix_agentd.d
Zabbix/History/{Host ID}/Free disk space on /var/lib/mysql
Zabbix/History/{Host ID}/Used disk space on /var/lib/mysql
Zabbix/History/{Host ID}/System uptime
Zabbix/History/{Host ID}/Number of running processes
Zabbix/History/{Host ID}/Used disk space on /etc/hostname
Zabbix/History/{Host ID}/Total memory
Zabbix/History/{Host ID}/Free disk space on /etc/Zabbix/
Zabbix/History/{Host ID}/Used disk space on /usr/lib/Zabbix/externalscripts
Zabbix/History/{Host ID}/Free disk space on /usr/lib/Zabbix/alertscripts
Zabbix/History/{Host ID}/Incoming network traffic on eth0
Zabbix/History/{Host ID}/Checksum of /etc/passwd
Zabbix/History/{Host ID}/Free disk space on /etc/hostname
Zabbix/History/{Host ID}/Number of logged in users
Zabbix/History/{Host ID}/Agent ping
Zabbix/History/{Host ID}/Used disk space on /etc/hosts
Zabbix/History/{Host ID}/Zabbix queue over 10m
Zabbix/History/{Host ID}/Free disk space on /usr/lib/Zabbix/externalscripts
Zabbix/History/{Host ID}/Host boot time
Zabbix/History/{Host ID}/Used disk space on /etc/resolv.conf
Zabbix/History/{Host ID}/Interrupts per second
Zabbix/History/{Host ID}/Free disk space on /etc/hosts
Zabbix/History/{Host ID}/Used disk space on /usr/lib/Zabbix/alertscripts
Zabbix/History/{Host ID}/Available memory
Zabbix/History/{Host ID}/Maximum number of processes

 

Troubleshooting

  1. Please look at the troubleshooting document and make sure that everything is followed correctly.

Contributing

Always feel free to fork and contribute any changes directly via GitHub.

 

Support

For any support questions, please contact help@appdynamics.com.

 

Version:

1.0.6

Compatibility:

3.7 and above

Zabbix Version:

2.4.4

Last Update:

09th Mar 2018

 

 Changes in versions:
1.0.0: Initial release
1.0.5: Added metric prefix with component, include/exclude hosts, metric character replacers
1.0.6: Updated Licenses