Instrumentez vos systèmes avec Agent Control

Instrumentez un système propre

Conseil

Agent Control est un service de supervision, il ne collecte, ni n’envoie de télémétrie par lui-même. Pour consulter les données dans New Relic, vous devez déployer des agents (tels que l’agent Infrastructure, ou NRDOT) via le contrôle de la flotte après l’installation d’Agent Control.

Kubernetes

Créez une flotte de type cluster Kubernetes dans le contrôle de la flotte. Consultez Créer votre première flotte pour les étapes détaillées.
Installer Agent Control. Suivez le guide d'installation de Kubernetes et sélectionnez la flotte que vous avez créée à l'étape 1.
Créez des configurations dans Fleet Control pour chacun de vos agents. Après la connexion d’Agent Control à Fleet Control, créez des configurations pour chacun de vos agents. Fleet Control est la source faisant autorité pour toute configuration d’agent, n’ajoutez pas de valeurs spécifiques à l’agent au values.yaml local.

Exemple d'ajout de l'agent d'infrastructure, de Fluent Bit, de Prometheus, et de NRDOT avec des paramètres personnalisés, chacune de ces configurations doit être créée en tant que configuration distante distincte dans le contrôle de la flotte :

Active l’agent New Relic Infrastructure avec des tolérances personnalisées et un intervalle de collecte de 30 secondes.

chart_values:
  newrelic-infrastructure:
    kubelet:
      tolerations:
        - operator: "Exists"
          effect: "NoSchedule"
        - operator: "Exists"
          effect: "NoExecute"
    common:
      config:
        interval: 30s

Déploie l'agent Prometheus en mode données réduites pour réduire le volume de télémétrie.

chart_values:
  newrelic-prometheus-agent:
    lowDataMode: true
    config:
      kubernetes:
        integrations_filter:
          enabled: false

Déploie la distribution New Relic du collecteur OpenTelemetry. Le Récepteur filelog est désactivé ici : activez-le si vous souhaitez la collecte de logs.

chart_values:
  nr-k8s-otel-collector:
    receivers:
      filelog:
        enabled: false

Créer un nouveau déploiement en ajoutant les configurations distantes tout juste créées à votre flotte. Agent Control appliquera automatiquement la nouvelle configuration à votre cluster. Suivez ces étapes dans créer et exécuter votre premier déploiement.
Vérifiez que les données circulent. Accédez à Infrastructure > Kubernetes dans l’UI de New Relic. Votre cluster devrait apparaître dans les 1 - 2 minutes suivant l’application de la configuration à distance. S’il n’apparaît pas, consultez le dépannage d’Agent Control.

Linux

Créez une flotte de type Hôte Linux dans le contrôle de la flotte. Consultez Créer votre première flotte pour les étapes détaillées.
Installer Agent Control. Suivez le guide d’installation pour Linux et sélectionnez la flotte que vous avez créée à l’étape 1.
Créez des configurations dans le contrôle de la flotte pour chacun de vos agents. Après la connexion d’Agent Control au contrôle de la flotte, créez des configurations pour chacun de vos agents.

Exemple d'ajout de l'agent d'infrastructure, nri-MySQL, nri-flex, fluentbit, et nrdot, chacune de ces configurations doit être créée en tant que configuration distante distincte dans le contrôle de la flotte :

config_agent contient la configuration minimale requise. license_key est résolu à l’exécution à partir de la variable d’environnement NEW_RELIC_LICENSE_KEY à l’aide du fournisseur de valeurs nr-env ; custom_attributes est facultatif mais recommandé pour le filtrage. config_logging transfère le syslog du système vers New Relic Logs.

config_agent:
  license_key: '${nr-env:NEW_RELIC_LICENSE_KEY}'
  custom_attributes:
    env: production
config_logging:
  logging.yml:
    logs:
      - name: syslog
        file: /var/log/syslog
        attributes:
          logtype: linux_syslog

Monitore une instance MySQL s’exécutant sur localhost. Le mot de passe est résolu au moment de l’exécution à partir de la variable d’environnement MYSQL_PASSWORD à l’aide du fournisseur de valeurs nr-env — ne codez jamais les identifiants en dur.

config:
  integrations:
    - name: nri-mysql
      env:
        HOSTNAME: localhost
        PORT: 3306
        USERNAME: newrelic
        PASSWORD: ${nr-env:MYSQL_PASSWORD}
        REMOTE_MONITORING: true
      interval: 30s

Collecte les statistiques d’utilisation du disque à partir du système de fichiers racine à l’aide de df. Cet exemple montre comment exécuter n’importe quelle commande shell et analyser sa sortie sous forme d’événements New Relic.

config:
  integrations:
    - name: nri-flex
      config:
        name: diskUsage
        apis:
          - event_type: DiskUsageSample
            commands:
              - run: df -kP /
                split: horizontal
                split_by: \s+
                set_header: [filesystem, blocks, used, available, usePercent, mountpoint]
                row_start: 1

Collecte les métriques d’hôte et les logs système, et ouvre un Récepteur OTLP pour les services APM. La clé de licence et le point de terminaison OTLP sont injectés automatiquement par Agent Control.

config:
  # Variables set automatically by Agent Control:
  # - NEW_RELIC_LICENSE_KEY: New Relic ingest license key.
  # - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint (see: https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/).

  extensions:
    health_check:

  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 60s
      scrapers:
        cpu:
          metrics:
            system.cpu.time:
              enabled: false
            system.cpu.utilization:
              enabled: true
        load:
        memory:
          metrics:
            system.memory.utilization:
              enabled: true
        paging:
          metrics:
            system.paging.utilization:
              enabled: false
            system.paging.faults:
              enabled: false
        filesystem:
          metrics:
            system.filesystem.utilization:
              enabled: true
        disk:
          metrics:
            system.disk.merged:
              enabled: false
            system.disk.pending_operations:
              enabled: false
            system.disk.weighted_io_time:
              enabled: false
        network:
          metrics:
            system.network.connections:
              enabled: false
        # Uncomment to enable process metrics, which can be noisy but valuable.
        # processes:
        # process:
        #  metrics:
        #    process.cpu.utilization:
        #      enabled: true
        #    process.cpu.time:
        #      enabled: false

    filelog:
      include:
        - /var/log/alternatives.log
        - /var/log/cloud-init.log
        - /var/log/auth.log
        - /var/log/dpkg.log
        - /var/log/syslog
        - /var/log/messages
        - /var/log/secure
        - /var/log/yum.log

  processors:
    metricstransform:
      transforms:
        - include: system.cpu.utilization
          action: update
          operations:
            - action: aggregate_labels
              label_set: [state]
              aggregation_type: mean
        - include: system.paging.operations
          action: update
          operations:
            - action: aggregate_labels
              label_set: [direction]
              aggregation_type: sum
    filter/exclude_cpu_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
    filter/exclude_memory_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
    filter/exclude_memory_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
    filter/exclude_filesystem_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
    filter/exclude_filesystem_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
    filter/exclude_filesystem_inodes_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
    filter/exclude_system_disk:
      metrics:
        datapoint:
          - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
    filter/exclude_system_paging:
      metrics:
        datapoint:
          - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
          - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
    filter/exclude_network:
      metrics:
        datapoint:
          - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
    attributes/exclude_system_paging:
      include:
        match_type: strict
        metric_names:
          - system.paging.operations
      actions:
        - key: type
          action: delete
    cumulativetodelta:
    transform/host:
      metric_statements:
        - context: metric
          statements:
            - set(description, "")
            - set(unit, "")
    transform:
      trace_statements:
        - context: span
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
      log_statements:
        - context: log
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
    memory_limiter:
      check_interval: 1s
      limit_mib: 100
    batch:
    resourcedetection:
      detectors: ["system"]
      system:
        hostname_sources: ["os"]
        resource_attributes:
          host.id:
            enabled: true
    resourcedetection/cloud:
      detectors: ["gcp", "ec2", "azure"]
      timeout: 2s
      ec2:
        resource_attributes:
          host.name:
            enabled: false
    resourcedetection/env:
      detectors: ["env"]
      timeout: 2s
      override: true

  exporters:
    otlphttp:
      endpoint: ${nr-env:OTEL_EXPORTER_OTLP_ENDPOINT}
      headers:
        api-key: ${nr-env:NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics/host:
        receivers: [hostmetrics]
        processors:
          - memory_limiter
          - metricstransform
          - filter/exclude_cpu_utilization
          - filter/exclude_memory_utilization
          - filter/exclude_memory_usage
          - filter/exclude_filesystem_utilization
          - filter/exclude_filesystem_usage
          - filter/exclude_filesystem_inodes_usage
          - filter/exclude_system_disk
          - filter/exclude_network
          - attributes/exclude_system_paging
          - transform/host
          - resourcedetection
          - resourcedetection/cloud
          - resourcedetection/env
          - cumulativetodelta
          - batch
        exporters: [otlphttp]
      logs/host:
        receivers: [filelog]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      traces:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      metrics:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      logs:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
    extensions: [health_check]

Créer un nouveau déploiement en ajoutant les configurations distantes tout juste créées à votre flotte. Agent Control appliquera automatiquement la nouvelle configuration à votre hôte, téléchargera et installera les packages OCI pour chacun des agents. Suivez ces étapes dans créer et exécuter votre premier déploiement.
Vérifiez que les données circulent. Accédez à Infrastructure > Hosts dans l’UI de New Relic. Votre hôte devrait apparaître sous 1 à 2 minutes. S’il n’apparaît pas, consultez le dépannage d’Agent Control.

Windows

Créez une flotte de type Hôte Windows dans le contrôle de la flotte. Consultez Créer votre première flotte pour les étapes détaillées.
Installer Agent Control. Suivez le guide d’installation de Windows et sélectionnez la flotte que vous avez créée à l’étape 1.
Créez des configurations dans le contrôle de la flotte pour chacun de vos agents. Après la connexion d’Agent Control au contrôle de la flotte, créez des configurations pour chacun de vos agents.

config_agent:
  license_key: '${nr-env:NEW_RELIC_LICENSE_KEY}'
  custom_attributes:
    env: production
config_logging:
  windows-event-log.yml:
    logs:
      - name: windows-event-log
        winevtlog:
          channel: System
        attributes:
          logtype: windows_event_log

Monitore une instance MySQL s’exécutant sur localhost. Le mot de passe est résolu à l’exécution à partir de la variable d’environnement MYSQL_PASSWORD à l’aide du fournisseur de valeurs nr-env.

config:
  integrations:
    - name: nri-mysql
      env:
        HOSTNAME: localhost
        PORT: 3306
        USERNAME: newrelic
        PASSWORD: ${nr-env:MYSQL_PASSWORD}
        REMOTE_MONITORING: true
      interval: 30s

Collecte les métriques de performances des disques logiques à l’aide de Get-CimInstance via PowerShell. Cet exemple montre comment nri-flex peut exécuter n’importe quelle commande PowerShell et analyser sa sortie JSON en tant qu’événements New Relic. Nécessite PowerShell v3+.

config:
  integrations:
    - name: nri-flex
      config:
        name: winDiskPerf
        apis:
          - event_type: WinDiskPerfSample
            shell: powershell
            commands:
              - run: >
                  Get-CimInstance -ClassName Win32_PerfFormattedData_PerfDisk_LogicalDisk |
                  Select-Object -Property Name, PercentFreeSpace, FreeMegabytes |
                  ConvertTo-Json

Collecte les métriques d’hôte et ouvre un Récepteur OTLP pour les services APM. La clé de licence et le point de terminaison OTLP sont injectés automatiquement par Agent Control.

config:
  # Variables set automatically by Agent Control:
  # - NEW_RELIC_LICENSE_KEY: New Relic ingest license key.
  # - OTEL_EXPORTER_OTLP_ENDPOINT: OTLP endpoint (see: https://docs.newrelic.com/docs/opentelemetry/best-practices/opentelemetry-otlp/).

  extensions:
    health_check:

  receivers:
    otlp:
      protocols:
        grpc:
        http:

    hostmetrics:
      collection_interval: 60s
      scrapers:
        cpu:
          metrics:
            system.cpu.time:
              enabled: false
            system.cpu.utilization:
              enabled: true
        load:
        memory:
          metrics:
            system.memory.utilization:
              enabled: true
        paging:
          metrics:
            system.paging.utilization:
              enabled: false
            system.paging.faults:
              enabled: false
        filesystem:
          metrics:
            system.filesystem.utilization:
              enabled: true
        disk:
          metrics:
            system.disk.merged:
              enabled: false
            system.disk.pending_operations:
              enabled: false
            system.disk.weighted_io_time:
              enabled: false
        network:
          metrics:
            system.network.connections:
              enabled: false

  processors:
    metricstransform:
      transforms:
        - include: system.cpu.utilization
          action: update
          operations:
            - action: aggregate_labels
              label_set: [state]
              aggregation_type: mean
        - include: system.paging.operations
          action: update
          operations:
            - action: aggregate_labels
              label_set: [direction]
              aggregation_type: sum
    filter/exclude_cpu_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
          - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
    filter/exclude_memory_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
          - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
    filter/exclude_memory_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
          - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
    filter/exclude_filesystem_utilization:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
    filter/exclude_filesystem_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
    filter/exclude_filesystem_inodes_usage:
      metrics:
        datapoint:
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
          - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
    filter/exclude_system_disk:
      metrics:
        datapoint:
          - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
          - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
    filter/exclude_system_paging:
      metrics:
        datapoint:
          - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
          - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
    filter/exclude_network:
      metrics:
        datapoint:
          - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
    attributes/exclude_system_paging:
      include:
        match_type: strict
        metric_names:
          - system.paging.operations
      actions:
        - key: type
          action: delete
    cumulativetodelta:
    transform/host:
      metric_statements:
        - context: metric
          statements:
            - set(description, "")
            - set(unit, "")
    transform:
      trace_statements:
        - context: span
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
      log_statements:
        - context: log
          statements:
            - truncate_all(attributes, 4095)
            - truncate_all(resource.attributes, 4095)
    memory_limiter:
      check_interval: 1s
      limit_mib: 100
    batch:
    resourcedetection:
      detectors: ["system"]
      system:
        hostname_sources: ["os"]
        resource_attributes:
          host.id:
            enabled: true
    resourcedetection/cloud:
      detectors: ["gcp", "ec2", "azure"]
      timeout: 2s
      ec2:
        resource_attributes:
          host.name:
            enabled: false
    resourcedetection/env:
      detectors: ["env"]
      timeout: 2s
      override: true

  exporters:
    otlphttp:
      endpoint: ${nr-env:OTEL_EXPORTER_OTLP_ENDPOINT}
      headers:
        api-key: ${nr-env:NEW_RELIC_LICENSE_KEY}

  service:
    pipelines:
      metrics/host:
        receivers: [hostmetrics]
        processors:
          - memory_limiter
          - metricstransform
          - filter/exclude_cpu_utilization
          - filter/exclude_memory_utilization
          - filter/exclude_memory_usage
          - filter/exclude_filesystem_utilization
          - filter/exclude_filesystem_usage
          - filter/exclude_filesystem_inodes_usage
          - filter/exclude_system_disk
          - filter/exclude_network
          - attributes/exclude_system_paging
          - transform/host
          - resourcedetection
          - resourcedetection/cloud
          - resourcedetection/env
          - cumulativetodelta
          - batch
        exporters: [otlphttp]
      traces:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      metrics:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
      logs:
        receivers: [otlp]
        processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
        exporters: [otlphttp]
    extensions: [health_check]

Créer un nouveau déploiement en ajoutant les configurations distantes tout juste créées à votre flotte. Agent Control appliquera automatiquement la nouvelle configuration à votre hôte, téléchargera et installera les packages OCI pour chacun des agents. Suivez ces étapes dans créer et exécuter votre premier déploiement.
Vérifiez que les données circulent. Accédez à Infrastructure > Hosts dans l’UI de New Relic. Votre hôte devrait apparaître sous 1 à 2 minutes. S’il n’apparaît pas, consultez le dépannage d’Agent Control.

Si vous avez déjà installé des agents, consultez plutôt Migrer vers Agent Control.

Cette traduction automatique est fournie pour votre commodité.

Instrumentez vos systèmes avec Agent Control

Instrumentez un système propre

Conseil

Kubernetes

Agent d'infrastructure

Fluent Bit (transfert de logs)

Prometheus

NRDOT (collecteur OpenTelemetry)

Linux

Agent d’infrastructure (base de référence)

nri-MySQL (intégration sur hôte)

nri-flex avec commande shell (intégration sur hôte)

NRDOT (collecteur OpenTelemetry)

Windows

Agent d’infrastructure (base de référence)

nri-MySQL (intégration sur hôte)

nri-flex avec commande PowerShell (intégration sur hôte)

NRDOT (collecteur OpenTelemetry)

Cette traduction automatique est fournie pour votre commodité.

Instrumentez vos systèmes avec Agent Control

Instrumentez un système propre.css-21sua1{background:none;border:none;width:0;padding:0;}

Conseil

Kubernetes

Fluent Bit (transfert de logs)

Prometheus

NRDOT (collecteur OpenTelemetry)

Linux

Agent d’infrastructure (base de référence)

nri-MySQL (intégration sur hôte)

nri-flex avec commande shell (intégration sur hôte)

NRDOT (collecteur OpenTelemetry)

Windows

Agent d’infrastructure (base de référence)

nri-MySQL (intégration sur hôte)

nri-flex avec commande PowerShell (intégration sur hôte)

NRDOT (collecteur OpenTelemetry)

Instrumentez un système propre