Datadogとの統合
TIP
Datadog統合はEMQX DedicatedおよびDedicated Flexのデプロイメントでのみ利用可能です。
Datadogは、アプリケーション、インフラストラクチャ、サーバレスのパフォーマンスをリアルタイムで監視・分析できる強力なプラットフォームです。EMQXのデプロイメントとDatadogを統合することで、主要なメトリクスを可視化し、アラートを設定し、システムの健全性やパフォーマンスに関する洞察を得ることができます。
本ガイドでは、EMQXのデプロイメントにDatadogを統合する手順と、利用可能な監視メトリクスの概要を説明します。
Datadogをデプロイメントに統合する方法
このセクションでは、EMQX CloudのデプロイメントにDatadogを統合し、デプロイメントのメトリクスをリアルタイムで収集・可視化する方法を説明します。
Datadogアカウントの準備
統合を設定する前に、Datadogアカウントと必要な認証情報を用意してください。
Datadogサイトの特定
Datadogは複数のグローバルサイトを運営しています。アカウントの地域に対応するDatadogサイトを選択する必要があります。
正しいサイトの特定方法については、Datadogサイトの開始方法をご参照ください。
Datadog APIキーの生成
EMQX CloudはDatadogにメトリクスを送信するためにAPIキーを必要とします。APIキーの作成方法は、APIおよびアプリケーションキーのドキュメントをご覧ください。
EMQX CloudでDatadog統合を有効化
以下の手順でEMQX Cloudデプロイメントに対してDatadog監視を有効にします。
- EMQX Cloudコンソールにログインし、対象のデプロイメントを開きます。
- 左側のナビゲーションメニューで Monitor -> Metrics をクリックします。
- Integration タブに切り替え、+ Configure Integration をクリックします。
- Configure Datadog ダイアログで以下の情報を入力します：
- Datadog API Key：Datadogアカウントで生成したAPIキーを入力します。
- Site：Datadogアカウントに対応するDatadogサイトを選択します（例：
datadoghq.com、datadoghq.euなど）。
- Confirm をクリックして設定を保存します。
統合が有効になると、EMQX CloudはデプロイメントのメトリクスをDatadogに送信し始めます。
Datadogダッシュボードのセットアップ
EMQX CloudはJSON形式の事前構成済みDatadogダッシュボードテンプレートを提供しています。GitHubのemqx/emqx-cloud-datadogリポジトリからダウンロード可能です。
ダッシュボードのインポート手順：
- ご利用の地域のDatadogサイトにアカウントでログインします。
- Dashboards -> New Dashboard -> Import Dashboard に移動します。
- GitHubからダウンロードしたJSONファイルをアップロードします。
インポート後、ダッシュボードは自動的にEMQXデプロイメントのメトリクスで埋められます。
統合の確認
統合完了後、Datadogダッシュボードでメトリクスが受信されているか確認してください。
データが表示されない、または問題が発生した場合は、EMQXテクニカルサポートまでお問い合わせください。
メトリクス概要
以下の表は、EMQXデプロイメントの監視に利用可能なDatadogメトリクスの一覧です：
| メトリクス名 | メトリクスタイプ | 説明 |
|---|---|---|
| emqx.cloud.action.dropped.count.count | カウンター | 指定されたアクションでドロップされたイベント数 |
| emqx.cloud.action.enable | ゲージ | アクションが有効なEMQXノード数 |
| emqx.cloud.action.events.count.count | カウンター | 指定されたアクションのイベント数 |
| emqx.cloud.action.queued.count | ゲージ | 指定されたアクションのキューイングされたイベント数 |
| emqx.cloud.action.retried.count.count | カウンター | 指定されたアクションのリトライイベント数 |
| emqx.cloud.action.status | ゲージ | 指定されたアクションの現在のステータス |
| emqx.cloud.authn.enable | ゲージ | 指定された認証方式が有効かどうか |
| emqx.cloud.authn.match.count | カウンター | 各認証方式の統計 |
| emqx.cloud.authn.status | ゲージ | 各認証方式の稼働状況 |
| emqx.cloud.authz.enable | ゲージ | 指定された認可方式が有効かどうか |
| emqx.cloud.authz.match.count | カウンター | 各認可方式の統計 |
| emqx.cloud.authz.status | ゲージ | 各認可方式の稼働状況 |
| emqx.cloud.cluster.status | ゲージ | EMQXクラスターのステータス |
| emqx.cloud.connections.count | ゲージ | クラスター内の現在の接続数 |
| emqx.cloud.deployment.authentication.failure.count | カウンター | 認証失敗数 |
| emqx.cloud.deployment.authentication.success.anonymous.count | カウンター | 匿名認証成功数 |
| emqx.cloud.deployment.authentication.success.count | カウンター | 認証成功数 |
| emqx.cloud.deployment.authorization.allow.count | カウンター | 認可許可数 |
| emqx.cloud.deployment.authorization.cache.hit.count | カウンター | 認可キャッシュヒット数 |
| emqx.cloud.deployment.authorization.cache.miss.count | カウンター | 認可キャッシュミス数 |
| emqx.cloud.deployment.authorization.deny.count | カウンター | 認可拒否数 |
| emqx.cloud.deployment.authorization.matched.allow.count | カウンター | マッチして許可された認可数 |
| emqx.cloud.deployment.authorization.matched.deny.count | カウンター | マッチしたが拒否された認可数 |
| emqx.cloud.deployment.authorization.nomatch.count | カウンター | マッチしなかった認可リクエスト数 |
| emqx.cloud.deployment.authorization.superuser.count | カウンター | スーパーユーザー認可数 |
| emqx.cloud.deployment.bytes.received.count | カウンター | 受信バイト数合計 |
| emqx.cloud.deployment.bytes.sent.count | カウンター | 送信バイト数合計 |
| emqx.cloud.deployment.channels.count | ゲージ | 現在のチャンネル数 |
| emqx.cloud.deployment.channels.max | ゲージ | チャンネル数の過去最大値 |
| emqx.cloud.deployment.client.auth.anonymous.count | カウンター | クライアントの匿名認証数 |
| emqx.cloud.deployment.client.authenticate.count | カウンター | クライアント認証試行数 |
| emqx.cloud.deployment.client.authorize.count | カウンター | クライアント認可リクエスト数 |
| emqx.cloud.deployment.client.connack.count | カウンター | クライアントのCONNACKメッセージ数 |
| emqx.cloud.deployment.client.connect.count | カウンター | クライアント接続試行数 |
| emqx.cloud.deployment.client.connected.count | カウンター | 現在接続中のクライアント数 |
| emqx.cloud.deployment.client.disconnected.count | カウンター | クライアント切断数 |
| emqx.cloud.deployment.client.disconnected.reason.count | カウンター | 理由別リスナー切断数 |
| emqx.cloud.deployment.client.subscribe.count | カウンター | クライアントのサブスクライブ数 |
| emqx.cloud.deployment.client.unsubscribe.count | カウンター | クライアントのサブスクライブ解除数 |
| emqx.cloud.deployment.cluster.sessions.count | ゲージ | クラスター内のセッション数 |
| emqx.cloud.deployment.cluster.sessions.max | ゲージ | クラスター内のセッション数の過去最大値 |
| emqx.cloud.deployment.connections.count | ゲージ | 現在の接続数 |
| emqx.cloud.deployment.connections.max | ゲージ | 接続数の過去最大値 |
| emqx.cloud.deployment.delayed.count | ゲージ | 遅延メッセージ数 |
| emqx.cloud.deployment.delayed.max | ゲージ | 遅延メッセージ数の過去最大値 |
| emqx.cloud.deployment.delivery.dropped.count | カウンター | 配信中にドロップされたメッセージ数 |
| emqx.cloud.deployment.delivery.dropped.expired.count | カウンター | 配信中にタイムアウトでドロップされたメッセージ数 |
| emqx.cloud.deployment.delivery.dropped.no.local.count | カウンター | 配信中にno_localフラグでドロップされたメッセージ数 |
| emqx.cloud.deployment.delivery.dropped.qos0.msg.count | カウンター | ドロップされたQoS 0メッセージ数 |
| emqx.cloud.deployment.delivery.dropped.queue.full.count | カウンター | キュー満杯による配信時のドロップメッセージ数 |
| emqx.cloud.deployment.delivery.dropped.too.large.count | カウンター | サイズ制限による配信時のドロップメッセージ数 |
| emqx.cloud.deployment.durable.subscriptions.count | カウンター | 現在のクラスター内の耐久サブスクリプション数 |
| emqx.cloud.deployment.durable.subscriptions.max | カウンター | クラスター内の耐久サブスクリプション数の過去最大値 |
| emqx.cloud.deployment.live.connections.count | ゲージ | クラスター内の耐久サブスクリプション数の過去最大値 |
| emqx.cloud.deployment.live.connections.max | ゲージ | アクティブ接続数の過去最大値 |
| emqx.cloud.deployment.messages.acked.count | カウンター | アックされたメッセージ数 |
| emqx.cloud.deployment.messages.delayed.count | カウンター | 遅延メッセージ数 |
| emqx.cloud.deployment.messages.delivered.count | カウンター | 配信済みメッセージ数 |
| emqx.cloud.deployment.messages.dropped.count | カウンター | ドロップされたメッセージ数 |
| emqx.cloud.deployment.messages.dropped.expired.count | カウンター | 有効期限切れでドロップされたメッセージ数 |
| emqx.cloud.deployment.messages.dropped.no.subscribers.count | カウンター | サブスクライバーなしでドロップされたメッセージ数 |
| emqx.cloud.deployment.messages.forward.count | カウンター | 転送されたメッセージ数 |
| emqx.cloud.deployment.messages.publish.count | カウンター | パブリッシュされたメッセージ数 |
| emqx.cloud.deployment.messages.qos0.received.count | カウンター | 受信したQoS 0パケット数 |
| emqx.cloud.deployment.messages.qos0.sent.count | カウンター | 送信したQoS 0パケット数 |
| emqx.cloud.deployment.messages.qos1.received.count | カウンター | 受信したQoS 1パケット数 |
| emqx.cloud.deployment.messages.qos1.sent.count | カウンター | 送信したQoS 1パケット数 |
| emqx.cloud.deployment.messages.qos2.received.count | カウンター | 受信したQoS 2パケット数 |
| emqx.cloud.deployment.messages.qos2.sent.count | カウンター | 送信したQoS 2パケット数 |
| emqx.cloud.deployment.messages.received.count | カウンター | 受信したメッセージ総数 |
| emqx.cloud.deployment.messages.retained.count | カウンター | 保持されたメッセージ数 |
| emqx.cloud.deployment.messages.sent.count | カウンター | 送信したメッセージ総数 |
| emqx.cloud.deployment.packets.auth.received.count | カウンター | 受信したAUTHパケット数 |
| emqx.cloud.deployment.packets.auth.sent.count | カウンター | 送信したAUTHパケット数 |
| emqx.cloud.deployment.packets.connack.auth.error.count | カウンター | 認証エラーを含むCONNACKメッセージ数 |
| emqx.cloud.deployment.packets.connack.error.count | カウンター | エラーのあるCONNACKパケット数 |
| emqx.cloud.deployment.packets.connack.sent.count | カウンター | 送信したCONNACKパケット数 |
| emqx.cloud.deployment.packets.connect.count | カウンター | 送信したCONNECTパケット数 |
| emqx.cloud.deployment.packets.disconnect.received.count | カウンター | 受信したDISCONNECTパケット数 |
| emqx.cloud.deployment.packets.disconnect.sent.count | カウンター | 送信したDISCONNECTパケット数 |
| emqx.cloud.deployment.packets.pingreq.received.count | カウンター | 受信したPINGREQパケット数 |
| emqx.cloud.deployment.packets.pingresp.sent.count | カウンター | 送信したPINGRESPパケット数 |
| emqx.cloud.deployment.packets.puback.inuse.count | カウンター | 使用中のPUBACKパケット数 |
| emqx.cloud.deployment.packets.puback.missed.count | カウンター | 失われたPUBACKパケット数 |
| emqx.cloud.deployment.packets.puback.received.count | カウンター | 受信したPUBACKパケット数 |
| emqx.cloud.deployment.packets.puback.sent.count | カウンター | 送信したPUBACKパケット数 |
| emqx.cloud.deployment.packets.pubcomp.inuse.count | カウンター | 使用中のPUBCOMPパケット数 |
| emqx.cloud.deployment.packets.pubcomp.missed.count | カウンター | 失われたPUBCOMPパケット数 |
| emqx.cloud.deployment.packets.pubcomp.received.count | カウンター | 受信したPUBCOMPパケット数 |
| emqx.cloud.deployment.packets.pubcomp.sent.count | カウンター | 送信したPUBCOMPパケット数 |
| emqx.cloud.deployment.packets.publish.auth.error.count | カウンター | 認証エラーを含むPUBLISHパケット数 |
| emqx.cloud.deployment.packets.publish.dropped.count | カウンター | ドロップされたPUBLISHパケット数 |
| emqx.cloud.deployment.packets.publish.error.count | カウンター | エラーのあるPUBLISHパケット数 |
| emqx.cloud.deployment.packets.publish.inuse.count | カウンター | 使用中のPUBLISHパケット数 |
| emqx.cloud.deployment.packets.publish.received.count | カウンター | 受信したPUBLISHパケット数 |
| emqx.cloud.deployment.packets.publish.sent.count | カウンター | 送信したPUBLISHパケット数 |
| emqx.cloud.deployment.packets.pubrec.inuse.count | カウンター | 使用中のPUBRECパケット数 |
| emqx.cloud.deployment.packets.pubrec.missed.count | カウンター | 失われたPUBRECパケット数 |
| emqx.cloud.deployment.packets.pubrec.received.count | カウンター | 受信したPUBRECパケット数 |
| emqx.cloud.deployment.packets.pubrec.sent.count | カウンター | 送信したPUBRECパケット数 |
| emqx.cloud.deployment.packets.pubrel.missed.count | カウンター | 失われたPUBRELパケット数 |
| emqx.cloud.deployment.packets.pubrel.received.count | カウンター | 受信したPUBRELパケット数 |
| emqx.cloud.deployment.packets.pubrel.sent.count | カウンター | 送信したPUBRELパケット数 |
| emqx.cloud.deployment.packets.received.count | カウンター | 受信したパケット総数 |
| emqx.cloud.deployment.packets.sent.count | カウンター | 送信したパケット総数 |
| emqx.cloud.deployment.packets.suback.sent.count | カウンター | 送信したSUBACKパケット数 |
| emqx.cloud.deployment.packets.subscribe.auth.error.count | カウンター | 認証エラーを含むSUBSCRIBEパケット数 |
| emqx.cloud.deployment.packets.subscribe.error.count | カウンター | エラーのあるSUBSCRIBEパケット数 |
| emqx.cloud.deployment.packets.subscribe.received.count | カウンター | 受信したSUBSCRIBEパケット数 |
| emqx.cloud.deployment.packets.unsuback.sent.count | カウンター | 送信したUNSUBACKパケット数 |
| emqx.cloud.deployment.packets.unsubscribe.error.count | カウンター | エラーのあるUNSUBSCRIBEパケット数 |
| emqx.cloud.deployment.packets.unsubscribe.received.count | カウンター | 受信したUNSUBSCRIBEパケット数 |
| emqx.cloud.deployment.retained.count | ゲージ | 現在の保持メッセージ数 |
| emqx.cloud.deployment.retained.max | ゲージ | 保持メッセージ数の過去最大値 |
| emqx.cloud.deployment.session.created.count | カウンター | 作成されたセッション数 |
| emqx.cloud.deployment.session.discarded.count | カウンター | 廃棄されたセッション数 |
| emqx.cloud.deployment.session.resumed.count | カウンター | 再開されたセッション数 |
| emqx.cloud.deployment.session.takenover.count | カウンター | session.takenoverフックがトリガーされた回数 |
| emqx.cloud.deployment.session.terminated.count | カウンター | 終了したセッション数 |
| emqx.cloud.deployment.sessions.count | ゲージ | 現在のセッション数 |
| emqx.cloud.deployment.sessions.max | ゲージ | セッション数の過去最大値 |
| emqx.cloud.deployment.suboptions.count | ゲージ | 現在のサブスクリプションオプション数 |
| emqx.cloud.deployment.suboptions.max | ゲージ | サブスクリプションオプション数の過去最大値 |
| emqx.cloud.deployment.subscribers.count | ゲージ | 現在のサブスクライバー数 |
| emqx.cloud.deployment.subscribers.max | ゲージ | サブスクライバー数の過去最大値 |
| emqx.cloud.deployment.subscriptions.count | ゲージ | 現在のサブスクリプション数 |
| emqx.cloud.deployment.subscriptions.max | ゲージ | サブスクリプション数の過去最大値 |
| emqx.cloud.deployment.subscriptions.shared.count | ゲージ | 現在の共有サブスクリプション数 |
| emqx.cloud.deployment.subscriptions.shared.max | ゲージ | 共有サブスクリプション数の過去最大値 |
| emqx.cloud.deployment.topics.count | ゲージ | 現在のトピック数 |
| emqx.cloud.deployment.topics.max | ゲージ | トピック数の過去最大値 |
| emqx.cloud.deployment.traffic.total.egress.bytes.count | カウンター | クラスターの送信トラフィック合計（バイト単位） |
| emqx.cloud.deployment.traffic.total.ingress.bytes.count | カウンター | クラスターの受信トラフィック合計（バイト単位） |
| emqx.cloud.disconnected.durable.sessions | ゲージ | 切断後に保持されたセッション数 |
| emqx.cloud.dropped.msg.rate | ゲージ | ドロップされたメッセージのレート |
| emqx.cloud.license.quota | ゲージ | ライセンスで許可されている最大接続数 |
| emqx.cloud.node.count | ゲージ | EMQXクラスター内のノード数 |
| emqx.cloud.persisted.rate | ゲージ | 永続化されたメッセージのレート |
| emqx.cloud.received.msg.rate | ゲージ | 1秒あたりの受信メッセージレート |
| emqx.cloud.resource.status | ゲージ | 指定されたリソースの現在のステータス |
| emqx.cloud.retained.msg.count | ゲージ | 保持されたメッセージ数 |
| emqx.cloud.rule.action.execution.count.count | カウンター | ルールアクションが実行された回数 |
| emqx.cloud.rule.matched.count.count | カウンター | マッチした合計回数 |
| emqx.cloud.rule.status | ゲージ | 指定されたルールの現在のステータス |
| emqx.cloud.sent.msg.rate | ゲージ | 1秒あたりの送信メッセージレート |
| emqx.cloud.sessions.count | ゲージ | クラスター内の現在のセッション数 |
| emqx.cloud.shared.subscriptions | ゲージ | 共有サブスクリプション数 |
| emqx.cloud.subscriptions | ゲージ | サブスクリプションの合計数 |
| emqx.cloud.subscriptions.durable | ゲージ | 耐久セッションが有効なサブスクリプション数 |
| emqx.cloud.subscriptions.ram | ゲージ | RAMに保存された非耐久サブスクリプション数 |
| emqx.cloud.topics | ゲージ | トピックの合計数 |
| emqx.cloud.transformation.failed.rate | ゲージ | 失敗したメッセージ変換のレート |
| emqx.cloud.transformation.succeeded.rate | ゲージ | 成功したメッセージ変換のレート |
| emqx.cloud.validation.failed.rate | ゲージ | 失敗したメッセージ検証のレート |
| emqx.cloud.validation.succeeded.rate | ゲージ | 成功したメッセージ検証のレート |