Documentation for a newer release is available. View Latest

Métricas

¿Cómo puedo recibir eventos y métricas relacionadas con mi connector?

Los connectors, de forma predeterminada, vienen con Lightbend Telemetry para reportar métricas. Esto permite exponer métricas a varios backends como Prometheus, Datadog, New Relic, etc.

El ejemplo de métricas mostrará cómo configurar métricas con Prometheus, uno de los sistemas de monitorización más extendidos.

Lightbend Telemetry se conocía anteriormente como Cinnamon. Verá referencias a ambos en estos ejemplos.

Esta guía también está disponible en el repositorio Git separado connector-samples aquí.

Agente Cinnamon

Antes de poder ejecutar el ejemplo, primero ejecute el siguiente objetivo de Maven.

mvn clean compile

Esto es importante porque copiará el JAR del agente de Cinnamon al directorio target. Esto se logra agregando la siguiente configuración de plugin en el archivo pom.xml.

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-dependency-plugin</artifactId>
    <executions>
        <execution>
            <id>copy</id>
            <phase>compile</phase>
            <goals>
                <goal>copy</goal>
            </goals>
            <configuration>
                <artifactItems>
                    <artifactItem>
                        <groupId>com.lightbend.cinnamon</groupId>
                        <artifactId>cinnamon-agent</artifactId>
                        <version>${cinnamon.version}</version>
                        <overWrite>true</overWrite>
                        <destFileName>cinnamon-agent.jar</destFileName>
                    </artifactItem>
                </artifactItems>
            </configuration>
        </execution>
    </executions>
</plugin>

Después de ejecutar el objetivo compile de Maven, debería haber un archivo dependency/cinnamon-agent.jar dentro del directorio target. Ahora podemos añadir el siguiente argumento de VM al ejecutar la prueba.

-javaagent:target/dependency/cinnamon-agent.jar

Si usa IntelliJ IDEA, puede ser necesario deshabilitar el agente Java de IntelliJ, ya que puede causar problemas con el agente Cinnamon. El agente puede deshabilitarse seleccionando Help > Edit Custom Properties.. y luego agregando idea.no.launcher=true al archivo de propiedades.

El agente Lightbend Telemetry (Cinnamon) puede adquirirse como parte de una suscripción a Lightbend. Más información sobre cómo configurarlo se puede encontrar aquí.

Esta prueba envía un mensaje vía un SendConnector usando un ConnectorTransport no-op durante una hora.

Verificar métricas

Si el argumento de VM anterior se establece correctamente, las métricas deberían publicarse en un servidor Prometheus que se ejecuta localmente y se expone en el puerto 9001.

Navegue a localhost::9001.
Debería haber una página llena de texto, mostrando varias métricas.
Busque "application_ipf_requests_sent"

La búsqueda debería mostrar el siguiente resultado. Esta métrica muestra el conteo total de mensajes enviados vía connectors.

application_ipf_requests_sent{application="com.intellij.rt.junit.JUnitStarter",host="some-hostname",connector="MetricsSendConnector",type="send",} 125.0

Esta estadística (y otras) pueden ser recolectadas por Prometheus e integradas en una librería de gráficos, como Grafana, para producir visualizaciones interesantes de los datos. Los tableros (dashboards) preconstruidos de Grafana por Lightbend se pueden encontrar aquí.