• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Intégration des services Windows

L'intégration des services Windows de New Relic collecte des données sur les services exécutés sur vos hôtes Microsoft Windows et les envoie à notre plateforme. Vous pouvez vérifier l'état et le mode de démarrage de chaque service, découvrir quels hôtes exécutent un service, configurer pour les services, et bien plus encore.

Avec notre intégration de services Windows, vous pouvez :

Notre intégration est fournie avec l'agent d'infrastructure Windows. Si vous monitoring des hôtes Windows sur New Relic, il vous suffit d'activer l'intégration pour obtenir les données des services Windows sur notre plateforme.

New Relic - Windows services integration - Metric data

one.newrelic.com > All capabilities > Dashboards:Vous pouvez utiliser les métriques d'intégration des services Microsoft Windows pour créer des tables pour vos services.

Compatibilité et exigences

Notre intégration est compatible avec toutes les versionsWindows prises en charge par l'agent New Relic Infrastructure.

Vous devez avoir version 1.12.1 or higher pour notre agent d'infrastructure installé sur un hôte pris en charge. Les versions Windows x86 ne sont pas encore prises en charge.

Installer l' agent d'infrastructure

Pour utiliser l’intégration des services Windows, vous devez d’abord installer l’agent d’infrastructure sur le même hôte. Toutes nos intégrations sur hôte nécessitent l'agent infrastructure , qui permet d'exposer et de rapporter les métriques à New Relic.

Configurer l’intégration des services Windows

Pour activer et configurer l’intégration des services Windows :

  1. Changez le répertoire vers le dossier d'intégration :

    bash
    $
    cd C:\Program Files\New Relic\newrelic-infra\integrations.d\
  2. Copiez l’exemple de fichier de configuration :

    bash
    $
    copy winservices-config.yml.sample winservices-config.yml
  3. Modifiez le fichier winservices-config.yml . Par défaut, aucun service n'est inclus. Pour inclure et filtrer les services, vous devez modifier include_matching_entities:.

    Voici un exemple de configuration d'intégration des services Windows avec à la fois un modèle d'expression régulière correspondant à tous les services nommés win32.* et une correspondance directe pour le service newrelic-infra :

    integrations:
    - name: nri-winservices
    config:
    exporter_bind_address: 127.0.0.1
    exporter_bind_port: 9182
    include_matching_entities:
    windowsService.name:
    - regex "win32.*"
    - "newrelic-infra"
    scrape_interval: 30s
    labels:
    env: production
    role: load_balancer
    timeout: 60s

    Pour plus d'informations, consultez notre documentation sur la structure générale de l'intégration sur configuration hôte.

Redémarrez l'agent New Relic Infrastructure

Redémarrez votre agent d’infrastructure :

bash
$
net stop newrelic-infra && net start newrelic-infra

Dans quelques minutes, votre application enverra des métriques à one.newrelic.com.

Trouvez vos données

Vous pouvez choisir notre modèle dashboard prédéfini nommé Windows services integration pour monitorer vos services Windows . Suivez ces étapes pour utiliser notre modèle dashboard prédéfini :

  1. De one.newrelic.com, aller à la page + Integrations & Agents .

  2. Cliquez sur Dashboards.

  3. Dans la barre de recherche, tapez Windows services.

  4. Le des Windows services dashboard devrait apparaître. Cliquez dessus pour l'installer.

    Votre des Windows services dashboard est considéré comme un dashboard personnalisé et peut être trouvé dans l'UI Dashboards. Pour obtenir des documents sur l'utilisation et la modification du dashboard, consultez notre documentation dashboard .

Configurer une alerte

Vous pouvez créer des services Windows à l’aide de conditions NRQL pour être informé des changements d’état des services que vous souhaitez monitorer. Voici deux exemples de conditions d’alerte qui utilisent les données des services Windows :

Comment ça marche

Pour obtenir des données à partir d'hôtes Windows , notre intégration de services Windows utilise une version réduite de l'exportateur Prometheus pour Windows, qui expose les métriques Prometheus sur le port spécifié dans la configuration de l'agent. L'intégration collecte ces métriques, les transforme en entité, les filtre, puis les envoie à New Relic.

Windows services integration architecture

L'intégration des services Windows collecte les données des fonctions de service à l'aide de l'exportateur Windows Prometheus. Il transforme et filtre ensuite les données avant de les envoyer à New Relic.

données métriques

L'intégration des services Windows fournit les données suivantes :

Conseil

Cette intégration crée des métriques dimensionnelles, qui renvoient l'état numérique fourni par la classe Win32_Service. L'énumération de ces métriques en valeurs de chaîne lisibles est fournie sous l'attribut start_mode et state .

Nom métrique

Attribut énuméré

Description

windows_service_start_mode

start_mode

Mode de démarrage du service. Les valeurs possibles sont :

  • boot
  • system
  • auto
  • manual
  • disabled

windows_service_state

state

Etat du service. Les valeurs possibles sont :

  • stopped
  • start pending
  • stop pending
  • running
  • continue pending
  • pause pending
  • paused
  • unknown

Étiquettes

Vous pouvez également décorer vos métriques et les étiqueter avec des étiquettes. Les étiquettes vous permettent d'ajouter une paire d'attributs valeur clé à vos métriques et balises afin que vous puissiez interroger, filtrer ou regrouper vos métriques et utiliser des balises pour regrouper, rechercher et filtrer les données sur votre entité.

Même si notre fichier de configuration d'exemple par défaut inclut des exemples d'étiquettes, ils sont facultatifs. Vous pouvez en supprimer, en modifier ou en ajouter de nouveaux.

labels:
env: production
role: load_balancer

Métadonnées

L'intégration des services Windows envoie les métadonnées suivantes à New Relic :

  • display_name: Nom du service tel qu'affiché dans le composant logiciel enfichable des services.

  • process_id: Identifiant du processus du service.

  • run_as: Nom du compte sous lequel un service s'exécute. Selon le type de service, le format du nom de compte peut être DomainName\Username ou Username@DomainName (UPN). La valeur est extraite de l'attribut StartName de la classe Win32_Service , qui peut être NULL (dans ce cas, l'étiquette est signalée comme une chaîne vide).

    Important

    Si l'attribut StartName est NULL, le service est connecté sous le compte LocalSystem . Pour le lecteur au niveau du noyau ou du système, il s'exécute avec un nom d'objet par défaut que le système I/O crée en fonction du nom du service, par exemple, DWDOM\Admin.

  • service_name: Identifiant unique du service.

    Important

    Le système convertit service_name en minuscule selon de bonnes pratiques. Il remplace tous les espaces et les points par des traits de soulignement. Ce n’est pas le même que le nom du service sur l’interface Windows.

code source

L'intégration des services Windows est un logiciel open source. Cela signifie que vous pouvez parcourir son code source et envoyer des améliorations, ou créer votre propre fork et le construire. Pour plus d'informations, consultez le fichier README.

Droits d'auteur © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.