Azure CosmosDB のモニター
「 Azure 」 CosmosDB センサーは、「 Instana 」エージェントをインストールすると、自動的に展開およびインストールされます。
Azure CosmosDBは、Microsoft のグローバル分散型マルチモデル・データベース・サービスです。 Instana コレクションごとのメトリクスの監視に対応しており、使用するモデルによっては、コレクションごとのモデル固有のメトリクスの監視にも対応しています。
データは、4 つのレベルのメトリックを使用してドリルダウン方式で編成されます。 集計されたインスタンスのメトリクスが表示されます。 これらのメトリックは、CosmosDb インスタンス全体に適用されます。
次の段階は、地域ごとの指標です。 リージョン・メトリックは、そのリージョン内に存在するすべてのコレクションを対象に集約されますが、リージョン間のトラフィックやその他のトラフィックも含まれます。 つまり、各地域ごとに表示される数値は、その地域内のすべてのコレクションのトラフィック合計よりも若干多めになっています。
第 3 レベルは、リージョンを展開すると表示されます。 ここでは、コレクションごとの指標を確認できます。 データモデルに基づき、各コレクションには追加のメトリクスがあり、コレクションビューを展開すると確認できます。
メトリクスの収集頻度は、 Azure Monitor SDKによって決定されます。
補足情報
クライアントサイドのトレースに対応
構成
Azure CosmosDB センサーは、無効にでき、タグおよびリソース・グループによってフィルタリングできます。 Azure CosmosDB センサーは、エージェント設定を使用して <agentinstall_dir>/etc/instana/configuration.yaml 次のように構成できます:
com.instana.plugin.azure.cosmosdb:
# Valid values: true, false
enabled: false # enabled (true) by default
# Comma separated list of tags in key:value format
include_tags:
# Comma separated list of tags in key:value format
exclude_tags:
# Comma separated list of resource groups
include_resource_groups:
# Comma separated list of resource groups
exclude_resource_groups:
Azure CosmosDB センサーを無効にできます。 Azure CosmosDB サービスのモニターを無効にするには、以下の構成を使用します。
com.instana.plugin.azure.cosmosdb:
enabled: false
複数のタグおよびリソース・グループを定義するには、コンマで区切ります。 タグは、: で区切られたキーと値のペアとして指定する必要があります。 構成を容易にするために、ディスカバリーに含めるタグおよびリソース・グループを定義することも、ディスカバリーから除外するタグおよびリソース・グループを定義することもできます。 「含める」リストと「除外する」リストの両方でタグまたはリソースグループを定義する場合、「除外する」リストが優先されます。 サービスのフィルタリングが不要な場合は、構成を定義しないでください。 フィルタリングを有効にするのに、すべての値を定義することは必須ではありません。
タグごとのサービスをディスカバリーに含めるには、以下の構成を使用します。
com.instana.plugin.azure.cosmosdb:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
タグごとのサービスをディスカバリーから除外するには、以下の構成を使用します。
com.instana.plugin.azure.cosmosdb:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
リソース・グループごとのサービスをディスカバリーに含めるには、以下の構成を使用します。
com.instana.plugin.azure.cosmosdb:
include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)
リソース・グループごとのサービスをディスカバリーから除外するには、以下の構成を使用します。
com.instana.plugin.azure.cosmosdb:
exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)
すべての Azure サービスに対して、グローバル・レベルでディスカバリー・フィルタリングを構成できます。 Azure CosmosDB サービス用のフィルターを定義する場合、グローバルフィルターは上書きされます。 グローバル Azure サービス・ディスカバリー・フィルタリングの詳細については、 Azure Configurationを参照してください。
メトリック収集
メトリクスを表示するには、 Instana のユーザーインターフェースのサイドバーで 「Infrastructure」 を選択し、監視対象の特定のホストをクリックします。すると、収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードが表示されます。
構成データ
CosmosDB インスタンスごとの静的情報のリスト。
| CosmosDB の詳細 | 説明 |
|---|---|
| 名前 | CosmosDB インスタンスの名前。 |
| リソース・グループ | CosmosDB インスタンスのリソース・グループ。 |
| Location | インスタンスが配置されている主要リージョン。 |
| サブスクリプション ID | CosmosDB インスタンスのサブスクリプション ID。 |
| 状態 | インスタンスの現在のデプロイメント状態。 |
| API | ドキュメントのモデルタイプ( GlobalDB,、 Cassandra、または MongoDB ) |
| タイプ | 文書タイプ |
| 種別 | データベース・アカウントのタイプを示します |
| エンドポイント | データベース・エンドポイント |
サマリー
CosmosDB インスタンス全体を対象に集約されたメトリックの第 1 レベル。
| CosmosDB インスタンスのメトリック | 説明 | 粒度 |
|---|---|---|
| ドキュメント数 | インスタンス全体に存在する文書の数 | 5 分 |
| サービス・アベイラビリティー | パーセント (%) で表示 | 1 時間 |
| 合計要求数 | 全要求の合計数 | 1 分 |
| メタデータ要求数 | メタデータ要求の合計数 | 1 分 |
| 読み取り待ち時間 | 1 分 | |
| 書き込み待ち時間 | 1 分 |
リージョン
リージョンごとのメトリックには、そのリージョン内のすべてのコレクションの集約データに加えて、リージョン間メトリックやメタデータ要求などのリージョン・レベルで発生するメトリックが含まれます。
| リージョンのメトリック | 粒度 |
|---|---|
| 合計要求数 | 1 分 |
| メタデータ要求数 | 1 分 |
| ドキュメント数 | 5 分 |
コレクション
各リージョンには 1 つ以上のコレクションがあります。 各コレクションには、ドキュメントモデルに関係なく利用可能な一連のメトリクスがあります:
| コレクションのメトリック | 説明 | 粒度 |
|---|---|---|
| 合計要求数 | 要求の合計数 | 1 分 |
| メタデータ要求数 | メタデータ要求の数 | 1 分 |
| ドキュメント数 | このコレクションに保管されている文書の数 | 5 分 |
| データ使用量 | すべての文書を保管するために使用されているバイト数 | 5 分 |
| インデックス使用量 | 使用可能なストレージの合計量 | 5 分 |
| 文書割り当て量 | 文書を保管するために使用可能なストレージの合計量 | 5 分 |
| 状況コード | 状況コードごとの合計要求数のメトリック | 1 分 |
ドキュメントモデル( API )に基づき、以下の追加メトリクスが収集されます:
Cassandra
| コレクションのメトリック | 説明 | 粒度 |
|---|---|---|
| リソース・タイプ | リソース・タイプごとの要求数 | 1 分 |
MongoDB
| コレクションのメトリック | 説明 | 粒度 |
|---|---|---|
| コマンド・タイプ | コマンド・タイプごとの要求 | 1 分 |
| エラー・コード | エラー・コード当たりの要求 | 1 分 |
正常性シグニチャー
センサーごとに、着信メトリックに対して継続的に評価され、ユーザーへの影響に応じて問題またはインシデントを提起するために使用される正常性シグニチャーのキュレーション済み知識ベースがあります。
組み込みイベントは、エンティティのヘルスシグネチャの異常に基づいて課題やインシデントをトリガーし、 カスタムイベントは、任意のエンティティの個々のメトリクスのしきい値に基づいて課題やインシデントをトリガーします。
Azure CosmosDB センサーのビルド・イベントについては、 組み込みイベントのリファレンスを参照してください。