Active Directoryの統合

Active Directory との統合により、ディレクトリサービス環境の健全性を簡単に監視し、潜在的な問題について積極的に警告することができます。

当社のインフラストラクチャエージェントを使用して構築された Active Directory 統合により、事前に構築された一連のとこれにより、最も重要なパフォーマンスデータをすべて 1 か所で確認できます。

ヒント

この統合は、オープンソースカテゴリの Community project [コミュニティプロジェクト] に分類されます。このコードは、問題や PR を通じてコミュニティからの意見を取り入れて公開で開発されています。New Relic 内にはアクティブなメンテナチームがあり、New Relic Explorers Hub でのトラブルシューティングサポートやプロジェクトリポジトリでドキュメントが利用可能です。

New Relic と Active Directory の統合をセットアップした後、すぐにこのようなダッシュボードでデータを確認できます。

インフラストラクチャエージェントをインストールします

New Relic で Active Directory データを確認するには、インフラストラクチャエージェントをインストールします。インフラストラクチャエージェントは、パフォーマンスカウンター、Windows サービス、PowerShell スクリプト、および Windows イベントログからデータを収集し、そのデータを New Relic に送信します。そこで、テレメトリを使用して Active Directory 環境の健全性を測定できます。

インフラストラクチャエージェントをインストールするには、次の 2 つの方法があります。

ガイド付きインストールに従って、システムにインフラストラクチャエージェントをインストルメント化します。
ドキュメントを使用して、コマンドラインからインフラストラクチャエージェントをインストールします。

New Relic を使用して Active Directory を計測する

インフラストラクチャエージェントを使用して Active Directory をインストルメントするには、このドキュメントと New Relic Active Directory 統合リポジトリの間で次の手順に従います。

CLI で次のコマンドを実行して、New Relic Active Directory 統合リポジトリのクローンを作成します。

bash

$git clone https://github.com/newrelic/newrelic-active-directory-integration.git

関連する構成ファイルをリポジトリからエージェントにコピーし、 $ROOT_PATH をリポジトリのクローンを作成したパスに置き換えます。

# integrations.d
Copy-Item -Path "$ROOT_PATH\newrelic-active-directory-integration\integrations.d\*"     -Destination "C:\Program Files\New Relic\newrelic-infra\integrations.d" -Recurse

# logging.d
Copy-Item -Path "$ROOT_PATH\newrelic-active-directory-integration\logging.d\*"     -Destination "C:\Program Files\New Relic\newrelic-infra\logging.d" -Recurse

これらの手順をすべて実行したら、New Relic I/O カタログから Active Directory クイックスタートをインストールして、関連するダッシュボードとアラートを追加できます。

データを見つけて使用する

Active Directory からのテレメトリの収集は、次のようなインフラストラクチャエージェントのディレクトリ構造にあるさまざまな構成ファイルとスクリプトファイルに依存します。

C:\Program Files\New Relic\newrelic-infra\
    ├── integrations.d
    │   ├── windows-active-directory-performance-counters.ps1
    │   ├── windows-active-directory-performance-counters.yml
    │   ├── windows-active-directory-replication-checks.yml
    │   ├── windows-active-directory-replication-failures.ps1
    │   ├── windows-active-directory-replication-partners.ps1
    │   └── windows-active-directory-services.yml
    └── logging.d
        └── windows-active-directory.yml

これらの各ファイルは連携して、完全な可観測性フットプリントを表示します。New Relic で得られるテレメトリは、メトリクス、イベント、ログデータで構成されます。

パフォーマンスカウンター

Active Directory パフォーマンスカウンターの収集は、次の PowerShell スクリプトと関連する構成ファイルを使用して、Flex 経由で実行されます。

windows-active-directory-performance-counters.ps1
windows-active-directory-performance-counters.yml

この収集の結果は、 activeDirectoryPerformanceCountersという名前のイベントとして保存されます。

イベントの詳細

イベント属性	カウンター名	説明
`addressBookClientSessions`	`\NTDS\AB Client Sessions`	接続されたアドレス帳クライアントセッションの数
`inboundFullSyncObjectsRemaining`	`\NTDS\DRA Inbound Full Sync Objects Remaining`	完全同期が完了するまでに残るオブジェクトの数
`draInbound`	`\NTDS\DRA Inbound Values (DNs only)/sec`	他のオブジェクトを参照する DN である受信レプリケーションパートナーから受信したオブジェクトプロパティ値の数
`draOutbound`	`\NTDS\DRA Outbound Values (DNs only)/sec`	アウトバウンド複製パートナーに送信された DN を含むオブジェクトプロパティ値の数
`draPendingReplicationSync`	`\NTDS\DRA Pending Replication Synchronizations`	このサーバーのキューに入れられているがまだ処理されていないディレクトリ同期の数
`directoryReadsPerSec`	`\NTDS\DS Directory Reads/sec`	1 秒あたりのディレクトリ読み取り数
`directoryWritesPerSec`	`\NTDS\DS Directory Writes/sec`	1 秒あたりのディレクトリ書き込み数
`directoryNotifyQueueSize`	`\NTDS\DS Notify Queue Size`	キューに入れられているがまだクライアントに送信されていない保留中の更新通知の数
`directoryThreadsInUse`	`\NTDS\DS Threads in Use`	ディレクトリサービスが使用している現在のスレッド数
`ldapActiveThreads`	`\NTDS\LDAP Active Threads`	ローカルディレクトリサービスの LDAP サブシステムが使用する現在のスレッド数
`ldapBindTime`	`\NTDS\LDAP Bind Time`	最後の LDAP バインドが完了するまでにかかった時間 (ミリ秒)
`ldapClientSessions`	`\NTDS\LDAP Client Sessions`	現在接続されているLDAPクライアントセッションの数
`ldapSearchesPerSec`	`\NTDS\LDAP Searches/sec`	LDAP クライアントが検索操作を実行する速度
`ldapSuccessfulBindsPerSec`	`\NTDS\LDAP Successful Binds/sec`	1 秒あたりの LDAP バインドの数
`contextSwitchesPerSec`	`\System\Context Switches/sec`	コンピューター上のすべてのプロセッサーがあるスレッドから別のスレッドに切り替わる合計速度。
`processorQueueLength`	`\System\Processor Queue Length`	キュー内で実行を待っているスレッドの数

自分のデータを見る

New Relic では、次の NRQL パターンを使用して結果をクエリできます。

FROM activeDirectoryHealthChecks SELECT
    latest(addressBookClientSessions),
    latest(inboundFullSyncObjectsRemaining),
    latest(draInbound),
    latest(draOutbound),
    latest(draPendingReplicationSync),
    latest(directoryReadsPerSec),
    latest(directoryWritesPerSec),
    latest(directoryNotifyQueueSize),
    latest(directoryThreadsInUse),
    latest(ldapActiveThreads),
    latest(ldapBindTime),
    latest(ldapClientSessions),
    latest(ldapSearchesPerSec),
    latest(ldapSuccessfulBindsPerSec),
    latest(contextSwitchesPerSec),
    latest(processorQueueLength)
SINCE 1 DAY AGO
LIMIT MAX

Windowsサービス

Active Directory Windows サービスの収集は、次の構成ファイルを使用したネイティブ Windows サービス統合によって実現されます。

windows-active-directory-services.yml

このコレクションの結果は、装飾されたラベル label.primary_app = 'active_directory'が付いたディメンションメトリックとして保存されます。

メトリクスの詳細

サービス名	説明
`ADWS`	Active Directory Web サービス
`DFS`	分散ファイルシステム
`DFSR`	DFS レプリケーション
`DNS`	DNSサーバー
`Dnscache`	DNSクライアント
`IsmServ`	サイト間メッセージング
`kdc`	Kerberos キー配布センター
`lanmanserver`	サーバー
`lanmanworkstation`	ワークステーション
`Netlogon`	ネットログオン
`NTDS`	Active Directory ドメインサービス
`RpcSs`	リモートプロシージャコール (RPC)
`SamSs`	セキュリティアカウントマネージャー
`W32Time`	ウィンドウズタイム

自分のデータを見る

New Relic では、次の NRQL パターンを使用して結果をクエリできます。

FROM Metric SELECT
    latest(timestamp) AS 'Reporting Time',
    latest(state) AS 'Current State',
    latest(start_mode) AS 'Start Mode'
FACET
    hostname AS 'Host',
    display_name AS 'Display Name',
    service_name AS 'Service Name',
    process_id AS 'Parent PID',
    run_as AS 'Service Account'
WHERE label.primary_app = 'active_directory'
SINCE 1 DAY AGO
LIMIT MAX

Active Directory レプリケーションのステータス

Active Directory パフォーマンスカウンターの収集は、次の 2 つの PowerShell スクリプトと関連する構成ファイルを使用して、Flex 経由で実行されます。

windows-active-directory-replication-checks.yml
windows-active-directory-replication-failures.ps1
windows-active-directory-replication-partners.ps1

この収集の結果は、 activeDirectoryReplicationFailures および activeDirectoryReplicationPartnersという名前のイベントとして保存されます。

イベントの詳細

イベント名	属性	説明
`activeDirectoryReplicationFailures`	`failureCount`	指定されたドメインコントローラーで発生したレプリケーションエラーの合計数を示す整数。
`activeDirectoryReplicationFailures`	`failureType`	指定されたドメインコントローラーで発生した最新の種類のレプリケーション障害の文字列表現。
`activeDirectoryReplicationFailures`	`firstFailureTime`	指定されたドメインコントローラーで最初に観察された障害を示すタイムスタンプ (`MM/dd/yyyy h:mm:ss tt`) 文字列。
`activeDirectoryReplicationFailures`	`lastError`	指定されたドメインコントローラーでのレプリケーションの失敗に関して最後に受信したエラーコードを示す整数。
`activeDirectoryReplicationFailures`	`server`	レプリケーションの失敗が発生したドメインコントローラーの文字列名。
`activeDirectoryReplicationPartners`	`lastReplicationAttempt`	サーバーとパートナー間のレプリケーションの最後の試行を示すタイムスタンプ (`MM/dd/yyyy h:mm:ss tt`) 文字列。
`activeDirectoryReplicationPartners`	`lastReplicationSuccess`	サーバーとパートナー間の最後に成功したレプリケーションを示すタイムスタンプ (`MM/dd/yyyy h:mm:ss tt`) 文字列。
`activeDirectoryReplicationPartners`	`partner`	レプリケーションのリモートパートナーの短縮名。
`activeDirectoryReplicationPartners`	`server`	のローカルサーバーの短縮名

自分のデータを見る

New Relic では、次の NRQL パターンを使用してレプリケーション統計をクエリできます。

FROM activeDirectoryReplicationFailures SELECT
    latest(failureType) AS 'Type',
    latest(failureError) AS 'Error',
    latest(firstFailureTime) AS 'First Failure',
    latest(failureCount) AS 'Attempts Made'
FACET
    server
SINCE 1 DAY AGO
LIMIT MAX

FROM activeDirectoryReplicationPartners SELECT
    latest(lastReplicationAttempt) AS 'Last Attempt',
    latest(lastReplicationSuccess) AS 'Last Success'
FACET
    server AS 'Source',
    partner AS 'Partner',
    if(lastReplicationSuccess != lastReplicationAttempt, 'Failed Replication', 'Successful Replication') AS 'Current Status'
SINCE 1 DAY AGO
LIMIT MAX

Windowsイベントログ

Active Directory Windows イベントの収集は、次の構成ファイルを使用して、インフラストラクチャエージェント上の統合ログフォワーダーで実行されます。

windows-active-directory.yml

この収集の結果は、装飾されたラベル logtype = 'active_directory'が付いたログとして保存されます。

ログの詳細

チャネル	イベントID	説明
セキュリティ	`4609`	Windows がシャットダウンしています
セキュリティ	`4616`	システム時刻が変更されました
セキュリティ	`4625`	アカウントがログオンに失敗しました
セキュリティ	`4648`	明示的な資格情報を使用してログオンが試行されました
セキュリティ	`4649`	リプレイアタッチが検出されました
セキュリティ	`4950`	IPsec メインモードセキュリティアソシエーションが確立されました
セキュリティ	`4697`	サービスがシステムにインストールされました
セキュリティ	`4713`	Kerberos ポリシーが変更されました
セキュリティ	`4714`	暗号化データ回復ポリシーが変更されました
セキュリティ	`4719`	システム監査ポリシーが変更されました
セキュリティ	`4720`	ユーザーアカウントが作成されました
セキュリティ	`4723`	アカウントのパスワードを変更しようとしました
セキュリティ	`4724`	アカウントのパスワードをリセットしようとしました
セキュリティ	`4725`	ユーザーアカウントが無効になりました
セキュリティ	`4726`	ユーザーアカウントが削除されました
セキュリティ	`4738`	ユーザーアカウントが変更されました
セキュリティ	`4739`	ドメインポリシーが変更されました
セキュリティ	`4740`	ユーザーアカウントがロックアウトされました
セキュリティ	`4781`	コンピューターアカウントが作成されました
システム	`1083`	セキュリティ記述子のバージョン番号を特定できませんでした
システム	`1202`	セキュリティポリシーは警告とともに広められました。0x534 : アカウント名とセキュリティ ID 間のマッピングは行われませんでした
システム	`1265`	次の書き込み可能なディレクトリパーティションのレプリケーションリンクを確立しようとして失敗しました
システム	`1311`	知識整合性チェッカー (KCC) は、次のディレクトリパーティションに関する問題を検出しました。
システム	`1388`	過去 [number] 日間。 1 つ以上のディレクトリパーティションでレプリケーションエラーが発生したため、現在のドメインコントローラ上の指定された名前付けコンテキストのレプリケーションが無効になりました
システム	`1645`	Active Directory ドメインサービスは、ドメインが「管理者」アカウントのデフォルトのパスワードをまだ使用していることを検出しました。
システム	`5805`	コンピューター [コンピューター名] からのセッションセットアップの認証に失敗しました
システム	`5807`	過去 [number] 日間。フォレスト内でいくつかのレプリケーションエラーが発生しました。フォレスト内でネットワークまたは接続の問題が発生している可能性があります

自分のデータを見る

New Relic では、次の NRQL パターンを使用して結果をクエリできます。

FROM Log SELECT
  hostname AS 'Host',
  Channel,
  EventID,
  message AS 'Message'
WHERE logtype = 'active_directory'
SINCE 1 DAY AGO
LIMIT MAX

ソースコードを確認してください

この統合はオープンソースソフトウェアです。つまり、ソースコードを参照して改善点を送信したり、独自のフォークを作成してビルドしたりすることができます。

この機械翻訳は参考用に提供されます。

ヒント

インフラストラクチャエージェントをインストールします

New Relic を使用して Active Directory を計測する

ステップ 1. リポジトリのクローンを作成する

ステップ 2. 構成ファイルをホストにコピーする

データを見つけて使用する

パフォーマンスカウンター

イベントの詳細

自分のデータを見る

Windowsサービス

メトリクスの詳細

自分のデータを見る

Active Directory レプリケーションのステータス

イベントの詳細

自分のデータを見る

Windowsイベントログ

ログの詳細

自分のデータを見る

ソースコードを確認してください

この機械翻訳は参考用に提供されます。

Active Directoryの統合

ヒント

インフラストラクチャエージェントをインストールします .css-21sua1{background:none;border:none;width:0;padding:0;}

New Relic を使用して Active Directory を計測する

ステップ 2. 構成ファイルをホストにコピーする

データを見つけて使用する

パフォーマンスカウンター

イベントの詳細

自分のデータを見る

Windowsサービス

メトリクスの詳細

自分のデータを見る

Active Directory レプリケーションのステータス

イベントの詳細

自分のデータを見る

Windowsイベントログ

ログの詳細

自分のデータを見る

ソースコードを確認してください

インフラストラクチャエージェントをインストールします