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キー、ベーシック認証、カスタムヘッダー方式をサポートしています。認証情報はSecure Vaultで暗号化されます。OAuth 2.0では、アクセストークンの有効期限切れ時にモニターが自動的に更新可能です。証明書ベースの認証（mTLS）はgRPCとHTTPSエンドポイントでサポートされています。SOAPモニターはWS-Securityのユーザ名トークンとX.509証明書をサポートします。

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