Web API モニタリング: 適切なプロトコルの選択

Dotcom-MonitorはREST、SOAP、GraphQL、gRPC、WebSockets、Webhookをサポートしています。RESTモニターはJSONPathアサーションとHTTPメソッドを検証します。SOAPモニターはWSDLを解析し、XPathでXMLを検証します。GraphQLモニターはクエリ、ミューテーション、およびネストされたデータ構造を処理します。gRPCモニターはProtobufレスポンスをデコードします。WebSocketモニターは双方向メッセージフローを追跡します。Webhookモニターは配信と再試行ロジックを検証します。

マルチステップモニターは最大20のAPIコールを順番に連鎖させます。各ステップは前のレスポンスからJSONPathまたはXPathを使ってデータを抽出し、それを次のリクエストのヘッダー、クエリパラメーター、またはボディフィールドとして渡します。例えば、ステップ1で/loginにPOSTしてJWTトークンを抽出し、ステップ2でAuthorizationヘッダーにそのトークンを使ってGET /cartを呼び出し、ステップ3でステップ2のカートIDを使ってPOST /checkoutを実行します。各ステップはタイミング、ステータスコード、レスポンスペイロードを独立して追跡します。

Dotcom-MonitorはOAuth 2.0（自動トークン更新付き）、JWT、APIキー、Basic認証、カスタムヘッダースキームをサポートします。資格情報はSecure Vaultで暗号化されます。OAuth 2.0ではアクセストークンの有効期限切れ時に自動更新が可能です。証明書ベース認証（mTLS）はgRPCおよびHTTPSエンドポイントでサポートされます。SOAPモニターはWS-SecurityユーザートークンとX.509証明書をサポートします。

はい。Dotcom-MonitorはPostman Collections（v2.1）とInsomniaエクスポートをワンクリックでインポートします。インポート処理はリクエスト、ヘッダー、認証、環境変数をDotcom-Monitorのモニターに変換します。マルチステップワークフローは保持され、インポート後にJSONPathアサーションを追加できます。{{baseUrl}}や{{authToken}}のような変数は自動的にDotcom-Monitor変数にマッピングされます。

RESTやGraphQLにはJSONPathアサーションを使います（例：$.status == “success” または $.items.length > 0）。SOAP XMLレスポンスにはXPathを使います（例：//OrderStatus/text() = “Confirmed”）。HTTPステータスコード（200, 201, 204, 400, 500）、レスポンスヘッダー（Content-Type、Cache-Control）、レスポンスタイムの閾値（例：ステップ1 < 500ms、ステップ3 < 2000ms）も検証可能です。カスタム検証のために正規表現のパターンマッチングも利用できます。

モニターが失敗した場合（ステータスコードエラー、アサーション失敗、タイムアウト、DNS解決失敗）、Dotcom-Monitorは30秒以内にSlack、PagerDuty、Microsoft Teams、メール、Webhookへアラートを送信します。アラートにはDNS解決時間、SSLハンドシェイク時間、各ステップのレスポンスタイム、完全なレスポンスペイロード、エラーメッセージといった詳細な診断情報が含まれます。誤検知を避けるためにモニターは3回再試行されてからアラートが発生します。

はい。Dotcom-Monitorのプライベートエージェントはネットワーク内部で動作し、内部API、ステージング環境、ファイアウォールで保護されたエンドポイントを監視します。エージェントはアウトバウンド接続でDotcom-Monitorプラットフォームと通信し（インバウンドファイアウォールルールは不要）、スケジュールに従ってモニタリングを実行し結果を報告します。プライベートエージェントはすべてのプロトコル（REST、SOAP、GraphQL、gRPC、WebSockets、Webhooks）とすべての認証方法をサポートします。

Dotcom-MonitorはREST APIおよびTerraformプロバイダーを提供し、モニターをコードとして管理できます。YAML設定ファイルを使ってCI/CDパイプラインからモニターの作成、更新、削除が可能です。Jenkins、GitLab CI、GitHub Actions、CircleCIからオンデマンドAPIチェックをトリガーします。APIレスポンスタイムが閾値を超えたりアサーションが失敗した場合はビルドを失敗させることが可能です。モニター構成はバージョン管理にエクスポートして監査証跡を残せます。