Home » 機能 » API

Dotcom-Monitor APIで監視のすべてを自動化する

プログラムによるモニターの作成、デバイスやタスクの管理、負荷テストのオーケストレーション、およびリアルタイムのパフォーマンスデータを独自のダッシュボード、SIEM、CI/CDパイプラインにストリーミングします — ドキュメント化されたREST Web APIとXMLレポーティングサービス(XRS)で。
Three floating dark-mode cards on a deep navy background — a Web API JSON request creating a new HTTPS monitor, an XRS XML response with a timing breakdown, and a live API-surface KPI panel showing requests, devices, locations, sessions, and last deploy.
10,000以上

世界中の組織

99.99%

プラットフォーム稼働時間SLA

30以上

世界の監視拠点

1998年から

ウェブサイト監視のリーダー

プログラムによる監視

Dotcom-Monitor APIとは?

Dotcom-Monitorプラットフォームは完全にスクリプト化可能です。新しいHTTPモニターの起動から、3か月間のパフォーマンスレポートの取得まで、Webインターフェースでできることはすべて、設定用のRESTベースのWeb APIと、リアルタイムデータ抽出用のXML Reporting Service(XRS)という2つの補完的なサービスを通じてプログラム的に実行できます。

Web APIは、監視および負荷テスト操作をあなたのシステムに公開する、構造化されたJSONベースのHTTPインターフェースです。これを使用して、すべてのデプロイメントで新しいモニターをプロビジョニングしたり、数千台のデバイスをコードとしての設定で一括管理したり、監視を既存のチケッティングツールに組み込んだり、顧客向けステータスページにライブのパフォーマンスデータを埋め込んだりできます。

XML Reporting Service(XRS)は、監視結果をXMLドキュメントとして返す無料のオンデマンドデータフィードです。任意のレポーティングダッシュボード、BIツール、Excelワークブック、内部データベースに指定して、エンジニアリングを待つことなくカスタムビューを構築できます。

これらを利用することで、プラットフォーム、SRE、およびDevOpsチームは完全にプログラムによる制御が可能になり、UIのクリックは一切不要です。

Web API — クイックリファレンス

https://api.dotcom-monitor.com/config_api_v1/

フォーマット

JSONリクエスト / JSONレスポンス

メソッド

GET(読み取り) · POST / PUT(書き込み / 更新)

認証

リクエストごとに60秒のセッション; IPホワイトリストは任意

トランスポート

HTTPまたはHTTPS

XRS — クイックリファレンス

https://xmlreporter.dotcom-monitor.com/reporting/xml/

フォーマット

HTTP(S) GETによるXMLレスポンス

認証

Manage > Integrationsで生成されたアカウントUID(PID)

データの深さ

最大6か月間遡れる生データのレスポンス

料金

無料、すべてのアカウントに含まれています

1

キーを生成する

アカウントでWeb APIまたはXMLフィードの統合を作成します。

2

構成する

デバイス、タスク、グループ、スケジュール、およびアラートを作成するためにJSONをPOSTします。
3

監視する

定義したスケジュールに従って、30か所以上のグローバルロケーションから実行されます。
4

抽出する

XRSを介して結果をダッシュボード、BI、Excel、または内部アプリに取り込みます。
コアAPI機能

UIでできることすべて — コードとして

アカウント内のすべての監視オブジェクトは一流のAPIリソースです。環境全体で個別または一括で管理できます。

完全なモニター構成

デバイス、タスク、グループ管理

ロケーションとスケジュール

アラートと通知連携

XRSリアルタイムレポーティングフィード

仕組み

ゼロから始める自動監視までの4ステップ

SDKのインストールは不要です。システムがHTTPリクエストを送信できれば、Dotcom-Monitorと連携可能です。

01

統合を作成する

Dotcom-Monitorのアカウントで、管理 > 統合に移動し、新しいWeb API統合(設定用)またはXMLフィード統合(レポート用)を作成します。必要に応じてIPアドレスによるアクセス制限を設定してください。

02

認証する

各リクエストは統合に対して認証されます。セッションは60秒の非アクティブ状態で期限切れとなり、アクセスは短時間かつ安全に保たれます。XRSリクエストは生成されたアカウントUID(PID)を使用します。

03

JSONリクエストを送信する

GETは読み取り用、POST/PUTは書き込み用に呼び出します。本文を送信する場合はContent-Type: application/jsonを設定してください。エラーは構造化されたJSONで返されます。

04

どこでも自動化する

APIをTerraform、Jenkins、GitHub Actions、Azure DevOps、または独自のスクリプトに組み込みます。デプロイ時にモニタのプロビジョニングをトリガーしたり、BIにパフォーマンスデータを取り込んだり、SLA違反時に自動でページングを行います。

技術仕様

2つのAPI。1つのアカウント。完全な制御。

Web APIは設定を担当し、XRSはレポートを担当します。単一の認証モデルを共有しており、すべてのDotcom-Monitorソリューションで機能します。

Web API(設定 & 制御)

モニタリングインフラをプログラムで管理します。

ベースURL

api.dotcom-monitor.com/config_api_v1/

プロトコル

HTTP、HTTPS

リクエスト形式

JSON(application/json)

レスポンス形式

JSON

メソッド

GET(読み取り)· POST、PUT(書き込み/更新)

認証

Web API 統合キー、リクエストごとのセッション(60秒タイムアウト)

アクセス制御

IPホワイトリストはオプション

対象範囲

モニタリング + LoadView メソッド

管理対象オブジェクト

デバイス、タスク、グループ、スケジュール、フィルター、アラート、ロケーション、ロードテスト、ユーザー

エラー処理

エラーコードとメッセージを含む構造化JSON

XML レポーティングサービス(XRS)

XML対応のあらゆるものにリアルタイムモニタリングデータをストリーム配信します。

ベースURL

xmlreporter.dotcom-monitor.com/reporting/xml/

プロトコル

HTTP、HTTPS

リクエスト形式

URLパラメータ付きHTTP(S) GET

レスポンス形式

XMLドキュメント

認証

XMLフィード連携で生成されたアカウントUID(PID)

対象範囲

アカウント全体または特定の部門に限定

レポートタイプ

デバイス設定、状態、未加工レスポンス、サマリー(時間/日/週/月/年)、3か月の統計

データ期間

未加工レスポンスは最大過去6か月分

フィルター

場所、スケジュール、デバイス、成功/失敗、部門、日付範囲

出力先

ダッシュボード、SQL、Excel、Power BI、カスタムアプリ

開発者に優しい

シンプルなHTTP。
SDKは不要。

すべての監視オブジェクト(デバイス、タスク、アラート、グループ、スケジュール)はJSONリソースとして表されます。こちらはXRSから監視データを取得し、Web APIを通じて新しいデバイスを登録する例です。curl、bashスクリプト、Pythonジョブ、CIステップなど、チームで使用している方法に簡単に組み込めます。

返されるフィールドにはDnsTimeSSLTimeConnectionTimeRequestTimeFirstPacketTime (TTFB)DownloadTimeDuration、ならびに場所、ステータス、監視タイムスタンプが含まれ、ウォーターフォールビューに直接利用可能です。

# リアルタイムXRSレポートを取得 — 場所ごとの概要
GET https://xmlreporter.dotcom-monitor.com/reporting/xml/responses.aspx
     ?PID=4229AF4F0FB545AEA75EAF2013E51BB7
     &Site=12345
     &Type=Overall
     &location=NY, USA

# レスポンス(省略)
<Response>
  <ID>3424533543</ID>
  <Name>Checkout API</Name>
  <URL>https://shop.example.com/api/checkout</URL>
  <Duration>114</Duration>
  <DnsTime>0</DnsTime>
  <SSLTime>18</SSLTime>
  <ConnectionTime>15</ConnectionTime>
  <FirstPacketTime>97</FirstPacketTime>
  <DownloadTime>2</DownloadTime>
  <Status>S</Status>
</Response>

# Web APIで新しいHTTPSモニターを作成
POST https://api.dotcom-monitor.com/config_api_v1/devices
Content-Type: application/json

{
  "name": "Checkout API — 本番",
  "platform": "HTTPS",
  "tasks": [{
    "url": "https://shop.example.com/api/checkout",
    "method": "POST",
    "keyword": "order_id"
  }],
  "frequency": 60,
  "locations": ["NY-USA", "FR-PARIS", "SG"]
}

5分で監視の自動化を始めましょう

すべての有料プランには完全なWeb APIおよびXRSアクセスが含まれており、アドオンや呼び出しごとの課金、追加の請求階層はありません。

ユースケース

チームがAPIで構築するもの

プラットフォームチーム、SRE、DevOpsエンジニアはDotcom-Monitor APIを使用し、すでに使っているワークフローに監視を組み込んでいます。

コードとしての監視

監視対象のサービスとともに各モニターをバージョン管理。既存のTerraformやPulumiパイプラインを通じてデバイスをプロビジョニング、更新、廃止し、ステージングと本番間のずれをなくします。

展開後のスモークテスト

Jenkins、GitHub Actions、Azure DevOpsからオンデマンドのHTTPSおよびマルチステップトランザクションチェックをデプロイごとにトリガー。新リリースで重要なエンドポイントが壊れた場合はビルドを失敗させます。

カスタムステータスページ & ダッシュボード

XRSデータを顧客向けの稼働時間ページ、内部NOC表示、または経営レベルのSLAレポートに供給。必要なフィールドのみ、求められるフォーマットで取得できます。

SLA証拠 & コンプライアンス報告

月次SLAエクスポート(稼働率%、P95 / P99応答時間、ダウンタイムインシデント)をXRSから直接ExcelまたはPDFに自動化 — 記録化、タイムスタンプ付き、監査準備完了。

大量デバイスプロビジョニング

買収、移行、CDN切替後に一括で数百のモニターを立ち上げ。既存のデバイステンプレートを複製し、適切なグループ、スケジュール、アラートルートを大規模に割り当て。

サードパーティダッシュボード埋め込み

Grafana、Power BI、Tableau、Datadogに監視データを送信し、他のテレメトリーと併せて利用可能 — 外部の合成チェックと内部APMトレースを関連付け。

マルチテナントアカウント管理

MSPおよび企業チームが数百の部門と数千のデバイスを一括管理可能。顧客ごとに部門別のXRSフィードを提供。

インシデント強化

モニターが発火すると、ウォーターフォール、サイファー、タイミングの内訳をXRS経由で取得し、自動的にPagerDutyやServiceNowのインシデントに添付してトリアージ時間を短縮。

XRS詳細解析

リアルタイムレポートを必要なかたちで

XML Reporting Serviceは柔軟で無料、オンデマンドのフィードです。概要データや生レスポンスを要求可能。場所、スケジュール、成功状態でフィルター。必要なフィールドのみ返却。

レポートタイプ
取得できるもの
典型的な使用例
アカウント利用状況
監視ソリューションごとの使用中および利用可能なリソース
ライセンス&キャパシティプランニング、請求照合
デバイスステータス
個別デバイスまたはセットの現在の状態とステータス
ライブステータスページ、NOCウォールダッシュボード
レスポンスの詳細
リクエスト毎に高度なカスタマイズ可能なタイミング&内容
詳細な診断、カスタムウォーターフォール、インシデントの充実
デバイス&タスク設定
エクスポートされた監視構成スナップショット
バックアップ、クロス環境クローン、監査記録
概要データ
稼働時間、停止時間、成功回数、失敗回数、性能、標準偏差
エグゼクティブサマリー、SLAレポート
生のレスポンス
デバイスごとのすべてのチェック結果(最大6ヶ月前まで)
法医学分析、履歴比較
時間別集計
1時間のウィンドウにまとめられたレスポンスデータ
ピーク負荷の識別、時間別トレンド分析
日別集計
24時間のウィンドウにまとめられたレスポンスデータ
日次オペレーションレビュー、平日と週末の比較
週次/月次/年次
より長期の時間軸にわたる要約
ボードレベルのトレンド、前年比のパフォーマンスレポート
3ヶ月の統計
ローリング3ヶ月ウィンドウで計算された統計データ
ベースライン由来のアラート、異常検知

すべてのレポートは、監視場所スケジュールDotcom-Monitorフィルター成功または失敗の状態部門、およびカスタム日付範囲でフィルタリングできます。

なぜチームはAPIを使うのか

DevOps、SRE、プラットフォームエンジニアリングのために作られた

Dotcom-Monitor APIは監視ワークフローから手動のUIクリックを取り除き、チームが人員を増やさずにシンセティックカバレッジを拡大できるようにします。

ドリフトを排除

監視設定をソース管理に保持します。同じ監視を環境全体に自信を持って適用できます。

モニタリングを左側にシフト

監視がカバーするサービスと同じPRにシンセティックチェックを追加します。モニタリングはコードと共に展開され、数週間後ではありません。

クリックなしでスケール

1つのスクリプトで100の新しいドメインや1000の新しいエンドポイントをオンボードします。クリック疲れなし。

詳細なセキュリティ

短命セッション、オプションのIPホワイトリスト、部門限定の統合キーでアクセスを厳格に管理。

どんなスタックにも適合

プレーンHTTP + JSON(レポート用にはGET + XML)。SDKロックインなし。すべての言語とCI/CDツールで動作。

データを自分のものに

監視データを独自のデータウェアハウス、BIプラットフォーム、またはコンプライアンスアーカイブにスケジュールに合わせて取り込みます。

統合されたインターフェース

1つのAPIが監視とLoadViewの負荷テストをカバー — 別ツール、別認証不要。

追加コストなし

APIとXRSアクセスはすべての有料プランに含まれています。呼び出しごとの課金なし、自動化も追加料金なし。

お客様の声

"Dotcomの最高の機能の一つは、ネットワークパフォーマンスデータを提供するプッシュ/プルAPI機能です。これを使ってパフォーマンスの問題やページの読み込み状況を監視しています。Dotcom-Monitorは一つのインターフェースとプラットフォームで複数のサービスを監視できるため、より効率的な運用が可能になりました。"
グレゴリー・S.
マネージャー、放送メディア · Verified Capterraレビュー

監視を自動化する準備はできていますか?

すべての30日間無料トライアルには、完全なWeb APIおよびXRSアクセスが含まれています — さらにすべての監視ソリューション、すべてのロケーション、およびすべての統合が利用可能です。自動監視がどのようなものか体験してください。

よくある質問

Dotcom-Monitor APIに関するよくある質問

Web APIconfig_api_v1)は、監視設定(デバイス、タスク、グループ、スケジュール、アラート、および負荷テスト)を作成・管理するためのJSONベースのRESTインターフェースです。XML Reporting Service(XRS)は、HTTP GETを介してXML形式で監視結果を返す別の無料フィードです。ほとんどのチームは両方を使用します:Web APIで設定し、XRSで結果を抽出します。

Dotcom-Monitorアカウントの管理 > 統合 > 新しい統合に進み、Web API統合(設定用)またはXMLフィード統合(XRS用)を作成します。すべてのWeb APIリクエストはその統合に対して認証され、非アクティブ状態が60秒続くとセッションは期限切れになります。XRSは生成されたアカウントUIDをPID URLパラメータとして使用します。IPアドレスによるアクセス制限も可能です。

Web APIは完全にJSON対応で、リクエストボディとレスポンスの両方がJSONです。JSONボディを送信する際はContent-Type: application/jsonを設定してください。XRSはHTTP(S) GETでXMLドキュメントを返すため、リクエストはクエリパラメータを含むURLのみです。

Web APIはすべてのDotcom-Monitor監視プラットフォームに対応しています:HTTPS、REST、SOAP、GraphQL、WebSocket、ServerView、BrowserView、UserView(EveryStepスクリプト)、およびMetricsView — さらにすべてのプロトコル監視(DNS、SSL、メール、FTP、ICMP Ping、TCPポート、Traceroute、VoIPなど)も対象です。またLoadView負荷テストの全領域もカバーします。

APIおよびXRSへのアクセスはすべての有料プランに含まれており、コールごとの計測や追加料金はありません。セッションは非アクティブ状態が60秒続くと期限切れとなり、長時間実行されるスクリプトを自然に制限します。IP制限付きアクセスやエンタープライズレベルのスループットが必要な場合は、エンタープライズオプションについて営業にお問い合わせください。

XRSは過去6か月分までの生データ応答を返すことができます。要約および統計レポート(時間別 / 日別 / 週別 / 月別 / 年別集計および3か月間の統計)は、より長期的な期間で利用可能です。各レポートの開始日時と終了日時を指定します。

はい — HTTPコールを実行できるツールならどれでもAPIが使えます。チームでは一般的にJenkins、GitHub Actions、GitLab CI、Azure DevOps、CircleCI、Terraformと連携して、デプロイ時のモニター設定、リリース後のスモークテスト実行、モニタリングの状態に基づく本番展開の制御を行っています。

はい。Web API統合を作成するときに、すべての認証済みリクエストからのアクセスを許可するか、信頼できるIPアドレスのリストに制限することができます。詳細はナレッジベースのWeb APIアクセス用IPホワイトリスト設定方法の記事を参照してください。

はい。ルートアカウントのユーザーはプログラムで部門を管理でき、XMLフィード統合は特定の部門に制限可能です。部門限定ユーザーは自分の部門のXRSレポートのみ取得でき、MSPやマルチテナント環境での明確な分離をサポートしています。

完全なドキュメントはDotcom-Monitorナレッジベースにあり、APIの開始方法ガイド、JSON例付きの監視およびLoadViewメソッド参照、XRSリクエストパラメータリファレンスが含まれています。利用可能なコードテンプレートはコード例セクションにあります。

監視を自動化。エンジニアリング時間を取り戻す。

10,000以上の組織がDotcom-Monitorを使い、顧客に先んじて障害を検知し、APIとXRSを使ってその監視カバレッジの管理を簡単にしています。