Las extensiones son módulos (paquetes de Java) desarrollados para extender la funcionalidad de nuestros agentes de Appdynamics, para el monitoreo por ejemplo de procesos, logs, bases de datos, Hipervisores, Nubes etc, etc..
Aquí pueden encontrar el detalle de todas las extensiones disponibles: https://developer.cisco.com/codeexchange/explore/#search=appdynamics
Este documento contiene algunos puntos claves, notas y detalles que te llevarán por un mejor camino en la implementación de nuestras extensiones.
Nota: Se requiere conocimiento básico de Java y de la estructura de un proyecto de Java realizado utilizando maven para poder utilizar nuestras extensiones.
Las extensiones pueden desplegarse de dos maneras, con el machine agent utilizando SIM (Server Infrastructure & Monitoring ) o sin esta funcionalidad por lo que es necesario validar previo al uso de la extensión la forma en que la utilizaremos, aquí más detalle: https://community.appdynamics.com/t5/Knowledge-Base/Monitoring-Extensions-Prerequisites-Guide/ta-p/35213
Las extensiones requieren de una compilación con maven, el cual es muy delicado en cuanto a sus versiones por lo que el comando mvn clean install puede fallar si usas una versión muy diferente de maven.
La versión que utilice y me funciono es la 3.0.4 la mayoría de los archivos pom.xml de las extensiones muestran que se usó la versión 2.3.X -> la cual ya no está disponible para su descarga EOL.
Adicional utilice la versión de Java 8 que es la recomendada en toda la documentación de las extensiones.
NOTA: Es posible realizar el build del proyecto con maven (mvn clean install) y generar el archivo .jar que puede ser trasladado a otros servidores y ejecutarse para no tener que realizar la instalación de maven y el proceso de build en cada servidor donde se ejecutará la extensión
Aquí pueden descargar la version de maven recomendada: https://archive.apache.org/dist/maven/maven-3/3.0.4/binaries/
Adicional, he adjuntado el paquete zip de maven en este articulo.
Las versiones anteriores de Maven utilizaban http y maven 3 utiliza https por lo que el build al ejecutar el comando mvn clean install puede fallar y es necesario añadir lo siguiente al final del archivo pom.xml pero no fuera de la etiqueta </project>
<pluginRepositories> <pluginRepository> <id>central</id> <name>Central Repository</name> <url>https://repo.maven.apache.org/maven2</url> <layout>default</layout> <snapshots> <enabled>false</enabled> </snapshots> <releases> <updatePolicy>never</updatePolicy> </releases> </pluginRepository> </pluginRepositories>
Adjunto Imagen:
Adicional es necesario agregar dentro de la etiqueta <repositories> el siguiente repositorio:
<repository>
<id>central</id>
<name>Central Repository</name>
<url>https://repo.maven.apache.org/maven2</url>
<layout>default</layout>
<snapshots>
<enabled>false</enabled>
</snapshots>
</repository>
Liga de referencia: https://stackoverflow.com/questions/59763531/maven-dependencies-are-failing-with-a-501-error
Las extensiones fueron desarrolladas en un momento específico del tiempo y la version mas nueva de nuestros agentes puede presentar diferencias que dificultan el despliegue de la extensión, las pruebas realizadas con éxito utilizaron la versión v20.5.1-2635 del machine agent el cual corre con su propio java version: 1.8.0_252
El agente puede ser descargado desde:
https://accounts.appdynamics.com/downloads
Espero que este pequeño manual te ayude a sortear los detalles técnicos que se presentan debido a la evolución constante de las tecnologías.
El detalle y la documentación del paso a paso para la configuración de cada extensión están presentes en la documentación de la misma por lo que no considere describir a detalle ese proceso en este documento.
Referencias adicionales sobre el tema: https://community.appdynamics.com/t5/Knowledge-Base/How-do-I-troubleshoot-missing-custom-metrics-or-extensions/ta-p/28695#how-build-and-place-extension
También es posible crear tu propia extension, aquí la documentación: https://docs.appdynamics.com/21.1/en/infrastructure-visibility/machine-agent/extensions-and-custom-metrics/build-a-monitoring-extension-using-scripts