Tencent Cloud MongoDB¶
スクリプトマーケットの「Guanceクラウド同期」シリーズスクリプトパッケージを使って、Cloud Monitor とクラウド資産のデータをGuanceに同期します
設定¶
Func のインストール¶
Guance統合 - 拡張 - マネージド版 Func を有効化することを推奨します。必要な前提条件はすべて自動でインストールされるので、そのままスクリプトのインストールを続けてください
Func を自前でデプロイする場合はFunc を自前でデプロイを参照してください
スクリプトの有効化¶
ヒント:要件を満たす Tencent Cloud AK を事前に準備してください(手早く進めるなら、グローバル読み取り専用権限
ReadOnlyAccessを直接付与してもかまいません)
マネージド版でスクリプトを有効化¶
- Guance コンソールにログインします
- [統合] メニューをクリックし、[クラウドアカウント管理] を選択します
- [クラウドアカウントの追加] をクリックし、[Tencent Cloud] を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みの場合は、この手順を省略します
- [テスト] をクリックし、成功したら [保存] をクリックします。テストに失敗した場合は、関連する設定情報が正しいか確認してから再度テストしてください
- [クラウドアカウント管理] の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページを開きます
- クラウドアカウント詳細ページの [統合] ボタンをクリックし、
未インストール一覧からTencent Cloud MongoDBを見つけて [インストール] ボタンをクリックすると、インストール画面が開くのでそのままインストールします
手動でスクリプトを有効化¶
-
Func コンソールにログインし、[スクリプトマーケット] をクリックして Guance スクリプトマーケットに入り、
integration_tencentcloud_mongodbを検索します -
[インストール] をクリックし、Tencent Cloud AK、SK、およびアカウント名を入力します
-
[起動スクリプトのデプロイ] をクリックすると、システムが
Startupスクリプトセットを自動作成し、対応する起動スクリプトを自動で設定します -
有効化後は「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ1回実行できます。しばらくすると、実行タスクの記録と対応するログを確認できます
確認¶
- 「管理 / 自動トリガー設定」で、対応するタスクに自動トリガー設定が存在するか確認し、あわせて該当タスクの記録とログを見て異常がないか確認します
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
Tencent Cloud の Cloud Monitor を設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます Tencent Cloud Cloud Monitor メトリクス詳細
リクエスト系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
Inserts_sum |
書き込みリクエスト数 | 単位時間内の書き込み回数 | 回 | target(インスタンス ID) |
Reads_sum |
読み取りリクエスト数 | 単位時間内の読み取り回数 | 回 | target(インスタンス ID) |
Updates_sum |
更新リクエスト数 | 単位時間内の更新回数 | 回 | target(インスタンス ID) |
Deletes_sum |
削除リクエスト数 | 単位時間内の削除回数 | 回 | target(インスタンス ID) |
Counts_sum |
count リクエスト数 | 単位時間内の count 回数 | 回 | target(インスタンス ID) |
Success_sum |
成功リクエスト数 | 単位時間内の成功リクエスト数 | 回 | target(インスタンス ID) |
Commands_sum |
command リクエスト数 | 単位時間内の command リクエスト数 | 回 | target(インスタンス ID) |
Qps_sum |
1秒あたりのリクエスト数 | 1秒あたりの操作数。CRUD 操作を含みます | 回/秒 | target(インスタンス ID) |
CountPerSecond_sum |
1秒あたりの count リクエスト数 | 1秒あたりの count リクエスト数 | 回/秒 | target(インスタンス ID) |
DeletePerSecond_sum |
1秒あたりの delete リクエスト数 | 1秒あたりの delete リクエスト数 | 回/秒 | target(インスタンス ID) |
InsertPerSecond_sum |
1秒あたりの insert リクエスト数 | 1秒あたりの insert リクエスト数 | 回/秒 | target(インスタンス ID) |
ReadPerSecond_sum |
1秒あたりの read リクエスト数 | 1秒あたりの read リクエスト数 | 回/秒 | target(インスタンス ID) |
UpdatePerSecond_sum |
1秒あたりの update リクエスト数 | 1秒あたりの update リクエスト数 | 回/秒 | target(インスタンス ID) |
遅延リクエスト系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
Delay10_sum |
遅延が10 - 50ミリ秒のリクエスト数 | 単位時間内の成功リクエスト遅延が10ms - 50msの回数 | 回 | target(インスタンス ID) |
Delay50_sum |
遅延が50 - 100ミリ秒のリクエスト数 | 単位時間内の成功リクエスト遅延が50ms - 100msの回数 | 回 | target(インスタンス ID) |
Delay100_sum |
100ミリ秒超のリクエスト数 | 単位時間内の成功リクエスト遅延が100ms超の回数 | 回 | target(インスタンス ID) |
AvgAllRequestDelay_sum |
全リクエスト平均遅延 | 全リクエストの平均遅延 | ms | target(インスタンス ID) |
接続数系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
ClusterConn_max |
クラスタ接続数 | クラスタ総接続数。現在クラスタ proxy が受け取った接続数を指します | 回 | target(インスタンス ID) |
Connper_max |
接続使用率 | 現在のクラスタの接続数と、クラスタ全体の接続数設定の比率 | % | target(インスタンス ID) |
システム系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
ClusterDiskusage |
ディスク使用率 | クラスタの現在の実使用ストレージ容量と総容量設定の比率 | % | target(インスタンス ID) |
入出力トラフィック系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
ClusterNetin |
入流量 | クラスタのネットワーク入流量 | Bytes | target(インスタンス ID) |
ClusterNetout |
出流量 | クラスタのネットワーク出流量 | Bytes | target(インスタンス ID) |
MongoDB レプリカセット¶
1. システム系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
ReplicaDiskusage |
ディスク使用率 | レプリカセット容量使用率 | % | target(レプリカセット ID) |
2. プライマリ/セカンダリ系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
SlaveDelay |
プライマリ/セカンダリ遅延 | プライマリ/セカンダリの単位時間あたりの平均遅延 | 秒 | target(レプリカセット ID) |
Oplogreservedtime |
oplog 保存時間 | oplog レコードにおける最後の操作と最初の操作の時間差 | 時間 | target(レプリカセット ID) |
3. キャッシュ系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
CacheDirty |
Cache の汚れデータ割合 | 現在のメモリ Cache 内の汚れデータ割合 | % | target(レプリカセット ID) |
CacheUsed |
Cache 使用割合 | 現在の Cache 使用割合 | % | target(レプリカセット ID) |
HitRatio |
Cache ヒット率 | 現在の Cache ヒット率 | % | target(レプリカセット ID) |
Mongo ノード¶
1. システム系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
CpuUsage |
CPU 使用率 | CPU 使用率 | % | target(ノード ID) |
MemUsage |
メモリ使用率 | メモリ使用率 | % | target(ノード ID) |
NetIn |
ネットワーク入流量 | ネットワーク入流量 | MB/s | target(ノード ID) |
NetOut |
ネットワーク出流量 | ネットワーク出流量 | MB/s | target(ノード ID) |
Disk |
ノードディスク使用量 | ノードディスク使用量 | MB | target(ノード ID) |
Conn |
接続数 | 接続数 | 回 | target(ノード ID) |
ActiveSession |
アクティブ session 数 | アクティブ session 数 | 回 | target(ノード ID) |
NodeOplogReservedTime |
Oplog 保存時間 | ノードの oplog 保存時間 | - | target(ノード ID) |
NodeHitRatio |
Cache ヒット率 | Cache ヒット率 | % | target(ノード ID) |
NodeCacheUsed |
Cache 使用割合 | Cache が総メモリに占める割合 | % | target(ノード ID) |
NodeSlavedelay |
プライマリ/セカンダリ遅延 | セカンダリノード遅延 | s | target(ノード ID) |
Diskusage |
ノードディスク使用率 | ノードディスク使用率 | % | target(ノード ID) |
Ioread |
ディスク読み取り回数 | ディスク読込 IOPS | 回/秒 | target(ノード ID) |
Iowrite |
ディスク書き込み回数 | ディスク書込 IOPS | 回/秒 | target(ノード ID) |
NodeCacheDirty |
Cache の汚れデータ割合 | Cache 内の汚れデータ比率 | % | target(ノード ID) |
2. 読み書き系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
Qr |
Read リクエスト待機キュー数 | Read リクエスト待機キュー数 | 個 | target(ノード ID) |
Qw |
Write リクエスト待機キュー数 | Write リクエスト待機キュー数 | 個 | target(ノード ID) |
Ar |
WT エンジンの ActiveRead | Read リクエストのアクティブ数 | 個 | target(ノード ID) |
Aw |
WT エンジンの ActiveWrite | Write リクエストのアクティブ数 | 個 | target(ノード ID) |
3. 遅延・リクエスト系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
NodeAvgAllRequestDelay |
全リクエスト平均遅延 | ノードの全リクエスト平均遅延 | ms | target(ノード ID) |
NodeDelay100 |
ノードの100ミリ秒超リクエスト数 | ノードの100ミリ秒超リクエスト数 | 回 | target(ノード ID) |
NodeDelay10 |
ノードの10-50ミリ秒間リクエスト数 | ノードの10-50ミリ秒間リクエスト数 | 回 | target(ノード ID) |
NodeDelay50 |
ノードの50-100ミリ秒間リクエスト数 | ノードの50-100ミリ秒間リクエスト数 | 回 | target(ノード ID) |
NodeSuccessPerSecond |
ノードの1秒あたりの成功リクエスト数 | ノードの1秒あたりの成功リクエスト数 | 回/秒 | target(ノード ID) |
NodeCountPerSecond |
ノードの1秒あたりの count リクエスト数 | ノードの1秒あたりの count リクエスト数 | 回/秒 | target(ノード ID) |
NodeDeletePerSecond |
ノードの1秒あたりの delete リクエスト数 | ノードの1秒あたりの delete リクエスト数 | 回/秒 | target(ノード ID) |
NodeInsertPerSecond |
ノードの1秒あたりの insert リクエスト数 | ノードの1秒あたりの insert リクエスト数 | 回/秒 | target(ノード ID) |
NodeReadPerSecond |
ノードの1秒あたりの read リクエスト数 | ノードの1秒あたりの read リクエスト数 | 回/秒 | target(ノード ID) |
NodeUpdatePerSecond |
ノードの1秒あたりの update リクエスト数 | ノードの1秒あたりの update リクエスト数 | 回/秒 | target(ノード ID) |
SuccessPerSecond |
総リクエスト | ノードの1秒あたりの成功リクエスト数 | 回/秒 | target(ノード ID) |
4. TTL インデックス系¶
| メトリクス英名 | メトリクス名 | 意味 | 単位 | ディメンション |
|---|---|---|---|---|
TtlDeleted |
TTL により削除されたデータ件数 | TTL により削除されたデータ件数 | 個 | target(ノード ID) |
TtlPass |
TTL の実行回数 | TTL の実行回数 | 個 | target(ノード ID) |
オブジェクト¶
収集された Tencent Cloud MongoDB オブジェクトデータ構造です。オブジェクトデータは「インフラストラクチャ-カスタム」で確認できます
{
"measurement": "tencentcloud_mongodb",
"tags": {
"ClusterType" : "0",
"InstanceId" : "cmxxxx",
"InstanceName": "test_01",
"InstanceType": "1",
"MongoVersion": "MONxxxx",
"NetType" : "1",
"PayMode" : "0",
"ProjectId" : "0",
"RegionId" : "ap-nanjing",
"Status" : "2",
"VpcId" : "vpc-nf6xxxxx",
"Zone" : "ap-nanjing-1",
"name" : "cmxxxx"
},
"fields": {
"CloneInstances" : "[]",
"CreateTime" : "2022-08-24 13:54:00",
"DeadLine" : "2072-08-24 13:54:00",
"ReadonlyInstances": "[]",
"RelatedInstance" : "{インスタンス JSON データ}",
"ReplicaSets" : "{インスタンス JSON データ}",
"StandbyInstances" : "[]",
"message" : "{インスタンス JSON データ}",
}
}
ログ¶
スロークエリ統計¶
前提条件¶
ヒント 1:このスクリプトのコード実行は MongoDB インスタンスのオブジェクト収集に依存します。MongoDB のカスタムオブジェクト収集を設定していない場合、スローログスクリプトではスローログデータを収集できません
スクリプトのインストール¶
これに加えて、対応する MongoDB スロークエリ統計ログ収集用スクリプト を追加でインストールする必要があります
「管理 / スクリプトマーケット」で対応するスクリプトパッケージをクリックしてインストールします。
- 「Guance統合(Tencent Cloud - MongoDB スロークエリログ収集)」(ID:
integration_tencentcloud_mongodb_slowlog)
データが正常に同期された後、Guance の「ログ」でデータを確認できます。
報告されるデータの例は次のとおりです。
{
"measurement": "tencentcloud_mongodb_slow_log",
"tags": {
},
"fields": {
"Slowlog": "スローログの詳細",
"message": "{インスタンス JSON データ}"
}
}
注意:
tags、fields内のフィールドは今後の更新により変更される場合がありますヒント 1:
tagsの値はカスタムオブジェクトによって補完されますヒント 2:
fields.messageは JSON シリアル化後の文字列ですヒント 3:
fields.Slowlogは、すべてのスロークエリ詳細レコードの各エントリです