Transférer les données du micromètre vers New Relic avec OpenTelemetry

New Relic prend en charge les données Micrometer afin que vous puissiez visualiser toutes vos métriques d'observabilité sur une seule plateforme. Vous configurerez le pont OpenTelemetry Micrometer avec le SDK OpenTelemetry, puis utiliserez le protocole OpenTelemetry (OTLP) pour transmettre vos données Micrometer à New Relic.

A screenshot of the Micrometer summary page when instrumented with OpenTelemetry

Accédez à one.newrelic.com > All Capabilities > APM & Services, puis recherchez la section Services - OpenTelemetry : Affichez vos données Micrometer dans New Relic lorsqu'elles sont reliées via OpenTelemetry

Compatibilité et exigences

Avant de suivre ces procédures, vous devez :

Configurer le SDK OpenTelemetry Métriques pour exporter des données vers New Relic via OTLP
Installer le pont micrométrique OpenTelemetry

Transférer les données du micromètre vers New Relic

Voici les étapes généralisées pour configurer le transfert des métriques Micrometer. Vous souhaiterez peut-être mettre à jour l'extrait de code si nécessaire pour l'adapter à votre environnement spécifique.

Ajouter l'instrumentation OpenTelemetry Micrometer

Ajoutez l'instrumentation OpenTelemetry Micrometer à la section des modules alpha de votre fichier build.gradle :

//Alpha modules
implementation 'io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5'

Ajouter la dépendance OpenTelemetry

Dans la section dependencies , ajoutez le SDK OpenTelemetry et l'exportateur OTLP :

dependencies {
  implementation 'io.opentelemetry:opentelemetry-sdk'
  implementation 'io.opentelemetry:opentelemetry-exporters-otlp'
}

Un exemple de fichier avec des modules alpha et des dépendances ajoutés pourrait ressembler à ceci :

plugins {
  id 'java-library'
  id 'org.springframework.boot'
}

bootRun {
  mainClass.set 'io.opentelemetry.example.micrometer.Application'
}

dependencies {
  implementation platform("io.opentelemetry:opentelemetry-bom-alpha:JAVA_OTEL_VERSION")
  implementation 'io.opentelemetry:opentelemetry-sdk'
  implementation 'io.opentelemetry:opentelemetry-exporters-otlp'

  implementation platform("io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom-alpha:OTEL_JAVA_INSTRUMENTATION_VERSION")
  implementation 'io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5'
}

Gardez à l’esprit que vous devrez mettre à jour le snippet avec le versionnement correct.

Configurer Micrometer pour transférer des données vers New Relic

Vous trouverez ci-dessous un exemple de snippet de code qui indique à Micrometer d'utiliser le pont OpenTelemetry Micrometer.

Cet snippet met à jour votre code afin OpenTelemetry puisse détecter les données Micrometer, puis transmettre ces données à New Relic:

public OpenTelemetry openTelemetry() {
  return OpenTelemetrySdk.builder()
    .setMeterProvider(
      SdkMeterProvider.builder()
        .setResource(
          Resource.getDefault()
            .toBuilder()
            .put("service.name", "micrometer-shim")
            // Include instrumentation.provider=micrometer to enable
            // micrometer metrics experience in New Relic
            .put("instrumentation.provider", "micrometer")
            .build())
        .registerMetricReader(
          PeriodicMetricReader.builder(
            OtlpHttpMetricExporter.builder()
              .setEndpoint("https://otlp.nr-data.net/v1/metrics")
              .addHeader("api-key",
                Optional
                  .ofNullable(System.getenv("NEW_RELIC_LICENSE_KEY"))
                  .filter(str -> !str.isEmpty() && !str.isBlank())
                  .orElseThrow())
              // IMPORTANT: New Relic exports data using delta
              // temporality rather than cumulative temporality
              .setAggregationTemporalitySelector(
                AggregationTemporalitySelector
                  .deltaPreferred())
              // Use exponential histogram aggregation for
              // histogram instruments to produce better data
              // and compression
              .setDefaultAggregationSelector(
                DefaultAggregationSelector.getDefault().with(
                  InstrumentType.HISTOGRAM,
                  Aggregation.base2ExponentialBucketHistogram()))
              .build())
          // Match default micrometer collection interval of 60
          // seconds
          .setInterval(Duration.ofSeconds(60))
          .build())
        .build())
    .build();
}

Retrouvez vos données dans New Relic

Attendez quelques minutes, déclenchez des données de test, puis accédez à one.newrelic.com > All Capabilities > APM & Services, puis recherchez Services - OpenTelemetry pour choisir le service instrumenté avec Micrometer.

Quelle est la prochaine étape ?

Pour en savoir plus sur l'utilisation de New Relic avec les données Micrometer, nous vous recommandons ces documents :

Apprenez à créer des visualisations personnalisées avec un dashboard
Configurer des alertes pour suivre les performances du système
Interrogez vos données avec NRQL