Web API 監視：適切なプロトコルの選択

Dotcom-MonitorはREST、SOAP、GraphQL、gRPC、WebSockets、およびWebhooksをサポートしています。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を使って/checkoutへPOSTします。各ステップはタイミング、ステータスコード、レスポンスペイロードを個別に追跡します。

Dotcom-MonitorはOAuth 2.0（自動トークン更新付き）、JWT、APIキー、Basic認証、およびカスタムヘッダースキームをサポートしています。資格情報はSecure Vaultで暗号化されます。OAuth 2.0ではアクセストークンの有効期限切れ時に自動的に更新が可能です。gRPCおよびHTTPSエンドポイント向けに証明書ベース認証（mTLS）もサポートしています。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プロバイダーを提供し、監視をコードとして管理できます。YAML設定ファイルを使ってCI/CDパイプラインからモニターの作成、更新、削除が可能です。Jenkins、GitLab CI、GitHub Actions、CircleCIからオンデマンドでAPIチェックをトリガーできます。API応答時間が閾値を超えるかアサーションに失敗した場合、ビルドを失敗させます。モニター構成はバージョン管理へエクスポートし、監査証跡を残せます。