Windowsサービスの統合

New RelicのWindowsサービス統合は、Microsoft Windowsホストで実行されているサービスに関するデータを収集し、それを当社のプラットフォームに送信します。各サービスの状態と開始モードを確認したり、サービスを実行しているホストを確認したり、サービスのアラートを設定したりできます。

私たちの統合は、 Windowsインフラストラクチャエージェントにバンドルされています。 New RelicでWindowsホストを監視している場合は、統合を有効にするだけで、Windowsサービスデータをプラットフォームに取り込むことができます。

重要な理由

Microsoft Windowsサービスは、UnixおよびLinuxのデーモンに相当するWindowsです。グラフィカルインターフェイスなしで開始、停止、一時停止、および再起動できる長時間実行可能ファイルです。 Windowsインフラストラクチャを監視するときは、有効になっているサービス、またはそれらの状態や状態を知ることが不可欠です。

Windowsサービスの統合により、次のことが可能になります。

• すべてのWindowsサービス、それらの状態（実行中、停止中など）、開始モード（自動、手動など）、およびその他のサービスメタデータを確認します。
• 特定のWindowsサービスを実行しているホストを確認します。
• NewRelicを使用して監視しているWindowsサービスに基づいてアラートを設定します。
• Windows サービス クイックスタート をインストールするか、独自の ダッシュボード を作成して、Windows サービスを追跡します。

互換性と要件

私たちの統合は、NewRelicエージェントでサポートされているすべてのWindowsバージョンと互換性があります。

サポートされているホストにインフラストラクチャ監視エージェントをインストールするには、バージョン1.12.1以降が必要です。 x86Windowsバージョンはまだサポートされていません。

インストールしてアクティブ化する

Windowsサービス統合をインストールするには：

1. ディレクトリを統合フォルダに変更します。

   bash

   コピー

   $
   cd C:\Program Files\New Relic\newrelic-infra\integrations.d\

2. サンプル構成ファイルのコピー：

   bash

   コピー

   $
   copy winservices-config.yml.sample winservices-config.yml

3. 構成設定の説明に従ってwinservices-config.ymlファイルを編集し、保存します。

統合を更新する

Windowsサービスの統合は、インフラストラクチャ監視エージェントにバンドルされています。統合を更新するには、エージェントを最新バージョンに更新します。

統合を構成する

統合を有効にするには、 winservices-config.ymlを編集して保存します。

• exporter_bind_address:のコメントを外し、 exporter_bind_port:
• 監視するサービスの名前を追加します include_matching_entities:

デフォルトでは、サービスは含まれていません。サービスを含めてフィルタリングするには、 include_matching_entities:を編集する必要があります。

また、構成オプションinventory_sourceは統合と互換性がありません。

Windowsサービス統合構成の例を次に示します。

integrations:
  - name: nri-winservices
    config:
      # IP address and port used by the Prometheus exporter to bind the server.
      # 
      # exporter_bind_address: 127.0.0.1  
      # exporter_bind_port: 9182

      # To include services, create a list of filters to be applied to the service names.
      # Services that find a match with any of the matching lists are included. By default,
      # no service is included.
      #
      # Currently, only windowsService.name metadata is supported for filtering.
      # Prepend "regex" to indicate that the pattern is a regular expression
      #
      include_matching_entities:
        windowsService.name:
          # - regex ".*"
          # - "newrelic-infra"

      # Time between consecutive metric collection of the integration.
      # It must be a number followed by a time unit (s, m or h), without spaces.
      #
      scrape_interval: 30s

    # Timeout used by the agent to restart the integration if no heartbeats are
    # sent from the integration. Heartbeats are sent every 5s, so this timeout
    # shouldn't be less than that.
    #
    timeout: 60s

    # Since this is a long-running integration, interval is ignored. To
    # configure the interval period for collecting and sending data, edit
    # the scrape_interval parameter.
    #
    # interval:

アラートを設定する

NRQL条件を使用してWindowsサービスアラートを作成し、監視するサービスの状態変化に関する通知を受け取ることができます。 Windowsサービスデータを使用するアラート条件の2つの例を次に示します。

SELECT count(*) FROM Metric WHERE metricName = 'windows_service_state' AND state != 'running' AND service_name = 'lfsvc' FACET entity.name

FROM Metric SELECT count(*) WHERE start_mode='auto' AND state!='running' FACET service_name

使い方

Windowsホストからデータを取得するために、Windowsサービス統合では、 Windows用のPrometheusエクスポーターの縮小バージョンを使用します。これにより、エージェント構成で指定されたポートでPrometheusメトリックが公開されます。統合により、これらのメトリックが収集され、エンティティに変換され、フィルタリングされてから、NewRelicに送信されます。

メトリックデータ

Windowsサービス統合は、次のデータを提供します。

メタデータ

Windowsサービス統合は、次のメタデータをNewRelicに送信します。

• display_name：サービススナップインに表示されるサービスの名前。

• service_name：サービスの一意の識別子。

• process_id：サービスのプロセス識別子。

• run_as：サービスを実行するアカウント名。サービスの種類に応じて、アカウント名の形式はDomainName\UsernameまたはUsername@DomainName （UPN）になります。値は、 Win32_ServiceクラスのStartName属性から取得されます。これはNULLの場合があります（この場合、ラベルは空の文字列として報告されます）。

  重要

  StartName属性がNULLの場合、サービスはLocalSystemアカウントでログオンします。カーネルまたはシステムレベルのドライブの場合、サービス名に基づいてI / Oシステムによって作成されたデフォルトのオブジェクト名（たとえば、 DWDOM\Adminで実行されます。

ソースコード

Windowsサービスの統合は、オープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。詳細については、 READMEを参照してください。