New Relic インフラストラクチャ モニタリング は、 Microsoft Azure の Cosmos DB サービスの統合を提供し、Cosmos DB のメトリクスやその他のデータを New Relic にレポートします。このドキュメントでは、Cosmos DB インテグレーションを有効にする方法と、取得可能なデータについて説明します。
機能
New Relicは、Azure Cosmos DBサービスからデータベースデータとコレクションの請求データの両方を収集します。New RelicからAzure Cosmos DBのデータを監視したり、アラートを出したりすることができ、 カスタムクエリやカスタムチャート・ダッシュボードを作成することができます 。
統合を有効にする
この統合を有効にするには、標準的な手順に従って、 New Relic で Azure サービスを有効にしてください。
Cosmos DBの統合では、データベースとコレクションのデータを取得するために、追加のロールとパーミッションを作成する必要があります。
Azure Portal にアクセスし、ターミナル アイコンを選択してシェルを開きます。
次のコマンドを追加します。
az role definition create --role-definition '{ "Name": "NewRelic Integrations", "Actions": [ "*/read", "Microsoft.DocumentDB/databaseAccounts/listKeys/action" ], "NotActions": [], "AssignableScopes": [ "/subscriptions/YOUR_INSERT_SUBSCRIPTION_ID" ], "Description": "Read Only for NewRelic Integrations", "IsCustom": "true" }'
「サービス」> 「サブスクリプション」 から、サブスクリプションを選択し、 「アクセスコントロール(IAM)」 から、 「追加」 を選択しています。
Role 検索ボックスに、新しく作成したロール定義の名前を追加します(例:
NewRelic Integrations
)。Select の検索ボックスに、New Relic の統合アプリケーションの名前を追加して選択します。
アプリケーションが Selected members リストに追加されていることを確認してから、 Save を実行します。
設定およびポーリング
設定オプションを使用し、ポーリングの頻度を変更し、データを絞り込むことができます。
デフォルト ポーリング Cosmos DBインテグレーションの情報です。
- ポーリングの間隔。5分
- 分解能は1 分または 5 分、メトリックによって異なります。特定のメトリックの解決情報については、 Microsoft Azureのサポートメトリックに関するドキュメント を参照してください。
データの表示と照会
統合データを表示するには、 one.newrelic.com > Infrastructure> Azure にアクセスし、Cosmos DB Integration を選択します。
データの照会や探索は、以下の イベントタイプ を使って行うことができます。
エンティティ | イベントタイプ | プロバイダー |
---|---|---|
アカウント |
|
|
データベース |
|
|
コレクション |
|
|
データの探し方や使い方については、 Understand and use integration data を参照してください。
メトリックデータ
重要
非推奨のCosmos DBイベントやメトリクスについては、 Azure Cosmos DB integration (deprecated) を参照してください。このドキュメントでサポートされているイベントやメトリクスに移行することを強くお勧めします。
Cosmos DBインテグレーションで報告されたメトリクスを表示するには、以下のEntityを照会します。各メトリクスに関連するメタデータを使用して、 フィルタリングやファセット 報告されているデータを表示します。メトリクスの詳細情報については、 Azure supported metrics のドキュメントを参照してください。
アカウントデータ
メトリック | 説明 | メタデータ |
---|---|---|
| リクエストの総数です。 |
|
| メタデータ・リクエストの数。 |
|
| Mongoリクエストの回数。 |
|
| 消費されたMongoリクエストユニットの合計数。 |
|
| 消費されたリクエストユニットの合計数 |
|
| データベースやコレクションに提供されるスループット。 |
|
| 利用可能な総ストレージ量(単位:バイト)。 |
|
| 報告されたデータ使用量の合計(単位:バイト)。 |
|
| 報告されたインデックスの総使用量(単位:バイト)。 |
|
| 報告された総ストレージ容量(単位:バイト)。 |
|
| 報告された総ドキュメント数 |
|
| P99 地理的に有効なアカウントのソースおよびターゲットリージョン間のレプリケーションレイテンシー(単位:ミリ秒)。 |
|
| アカウントは、1時間、1日、1ヶ月単位での稼働率を要求します。 | 特定のメタデータはありません。 |
| 作成されたCassandraリクエストの数 |
|
| Cassandraリクエストで消費されたリクエスト・ユニットの合計数。 |
|
| 閉じたCassandra接続の合計数。 |
|
データベースデータ
メトリック | 説明 | メタデータ |
---|---|---|
| リクエストの総数です。 |
|
| メタデータ・リクエストの数。 |
|
| Mongoリクエストの回数。 |
|
| 消費されたMongoリクエストユニットの合計数。 |
|
| 消費されたリクエストユニットの合計数 |
|
| データベースやコレクションに提供されるスループット。 |
|
| 利用可能な総ストレージ量(単位:バイト)。 |
|
| 報告されたデータ使用量の合計(単位:バイト)。 |
|
| 報告されたインデックスの総使用量(単位:バイト)。 |
|
| 報告された総ストレージ容量(単位:バイト)。 |
|
| 報告された総ドキュメント数 |
|
| P99 地理的に有効なアカウントのソースおよびターゲットリージョン間のレプリケーションレイテンシー(単位:ミリ秒)。 |
|
| アカウントは、1時間、1日、1ヶ月単位での稼働率を要求します。 | 特定のメタデータはありません。 |
| 作成されたCassandraリクエストの数 |
|
| Cassandraリクエストで消費されたリクエスト・ユニットの合計数。 |
|
| 閉じたCassandra接続の合計数。 |
|
データベースデータ
メトリック | 説明 | メタデータ |
---|---|---|
| リクエストの総数です。 |
|
| メタデータ・リクエストの数。 |
|
| Mongoリクエストの回数。 |
|
| 消費されたMongoリクエストユニットの合計数。 |
|
| 消費されたリクエストユニットの合計数 |
|
| データベースやコレクションに提供されるスループット。 |
|
| 利用可能な総ストレージ量(単位:バイト)。 |
|
| 報告されたデータ使用量の合計(単位:バイト)。 |
|
| 報告されたインデックスの総使用量(単位:バイト)。 |
|
| 報告された総ストレージ容量(単位:バイト)。 |
|
| 報告された総ドキュメント数 |
|
| P99 地理的に有効なアカウントのソースおよびターゲットリージョン間のレプリケーションレイテンシー(単位:ミリ秒)。 |
|
| アカウントは、1時間、1日、1ヶ月単位での稼働率を要求します。 | 特定のメタデータはありません。 |
| 作成されたCassandraリクエストの数 |
|
| Cassandraリクエストで消費されたリクエスト・ユニットの合計数。 |
|
| 閉じたCassandra接続の合計数。 |
|
コレクションデータ
メトリック | 説明 | メタデータ |
---|---|---|
| リクエストの総数です。 |
|
| メタデータ・リクエストの数。 |
|
| Mongoリクエストの回数。 |
|
| 消費されたMongoリクエストユニットの合計数。 |
|
| 消費されたリクエストユニットの合計数 |
|
| データベースやコレクションに提供されるスループット。 |
|
| 利用可能な総ストレージ量(単位:バイト)。 |
|
| 報告されたデータ使用量の合計(単位:バイト)。 |
|
| 報告されたインデックスの総使用量(単位:バイト)。 |
|
| 報告された総ストレージ容量(単位:バイト)。 |
|
| 報告された総ドキュメント数 |
|
| P99 地理的に有効なアカウントのソースおよびターゲットリージョン間のレプリケーションレイテンシー(単位:ミリ秒)。 |
|
| アカウントは、1時間、1日、1ヶ月単位での稼働率を要求します。 | 特定のメタデータはありません。 |
| 作成されたCassandraリクエストの数 |
|
| Cassandraリクエストで消費されたリクエスト・ユニットの合計数。 |
|
| 閉じたCassandra接続の合計数。 |
|
インベントリデータ
有効期限(EOL)の通知
2022年3月以降は、クラウド統合用のインベントリデータなど、いくつかの機能のサポートを終了します。この移行に向けて簡単に準備できる方法など、詳細については、 Explorers Hubの投稿 をご覧ください。
インベントリデータは、システムの状態や構成に関する情報です。インベントリデータの見つけ方と使い方の詳細は、 データの理解と利用 をご覧ください。
Cosmos DBインテグレーションでは、次のメタデータを使用して、エンティティタイプ azure/cosmosdb/account/
のインベントリデータがレポートされます。
documentEndpoint
: ドキュメントのエンドポイントです。databaseAccountOfferType
: データベースアカウントのオファータイプです。consistencyPolicy
: Cosmos DBデータベース・アカウントの一貫性ポリシーです。defaultConsistencyLevel
: Cosmos DBデータベース・アカウントのデフォルトの一貫性レベルです。種類
: データベースアカウントの作成時に設定されたデータベースアカウントの種類です。resourceGroupName
: Cosmos DBデータベースアカウントが所属するAzureリソースグループ名です。regionName
:Azure DocumentDB データベースアカウントが展開されているリージョン名です。タイプ
: azure リソースタイプで、Microsoft.DocumentDB/databaseAccounts
.