Métricas

¿Cómo puedo recibir events y métricas relacionadas con mi conector?

Los conectores, por defecto, vienen con Lightbend Telemetría para informar métricas. Esto permite que las métricas se expongan a través de 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 monitoreo más prevalentes.

Lightbend Telemetry era anteriormente conocido como Cinnamon. Usted verá referencias a ambos en estos ejemplos.
Esta guía también está disponible en el separado connector-samples Repositorio de Git aquí.

Agente de Canela

Antes de que podamos ejecutar el ejemplo, primero ejecute lo siguiente maven objetivo.

mvn clean compile

Esto es importante porque copiará el archivo JAR del agente de canela en el directorio de destino. Esto se logra añadiendo la siguiente configuración del complemento en el pom.xml archivo.

<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 maven compilar objetivo, debe haber un dependency/cinnamon-agent.jar archivo dentro del target directorio. Ahora podemos añadir el siguiente argumento de VM al ejecutar la prueba.

-javaagent:target/dependency/cinnamon-agent.jar
Si utiliza IntelliJ IDEA, puede ser necesario deshabilitar el IntelliJ Java agente, ya que puede causar problemas con el agente Cinnamon. El agente puede ser deshabilitado seleccionando Help > Edit Custom Properties. y luego añadiendo idea.no.launcher=true al archivo de propiedades.

El Agente de Telemetría de Lightbend (Cinnamon) puede ser adquirido como parte de una suscripción a Lightbend. Más información sobre cómo configurar eso se puede encontrar aquí.

Esta prueba envía un mensaje a través de un SendConnector utilizando un no-op ConnectorTransport por una hora.

Verifique Métricas

Si el argumento de VM anterior está configurado correctamente, las métricas deberían publicarse en un ejecutándose localmente.prometheus servidor que está expuesto en el puerto 9001.

  1. Navegue a link::http://localhost:9001[localhost::9001].

  2. Debería haber una página llena de texto, mostrando diversas métricas.

  3. Busque "application_ipf_requests_sent"

La búsqueda debe mostrar el siguiente resultado. Esta métrica muestra el conteo total de mensajes enviados a través de conectores.

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

Esta estadística (y otras) puede ser extraída por Prometheus y se introduce en una biblioteca de gráficos, como Grafana para producir visualizaciones interesantes de los datos. Preconstruido Grafana Los gráficos de Lightbend se pueden encontrar aquí.