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か月間のパフォーマンスレポートの取得まで、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

設定

POST JSONでデバイス、タスク、グループ、スケジュール、アラートを作成します。
3

監視

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

抽出

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

UIができるすべてをコードとして

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

完全な監視構成

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

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

アラート&通知統合

XRSリアルタイムレポートフィード

仕組み

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

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

01

インテグレーションを作成

Dotcom-Monitorアカウントで、Manage > Integrations に移動し、新しいWeb APIインテグレーション(設定用)またはXML Feedインテグレーション(レポーティング用)を作成します。必要に応じてIPアドレスでアクセスを制限できます。

02

認証

各リクエストはインテグレーションに対して認証されます。セッションは60秒の非アクティブ時間後に期限切れとなり、アクセスを短時間かつ安全に保ちます。XRSリクエストは生成されたAccount 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ホワイトリストは任意

対象範囲

Monitoring + 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 — Production",
  "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レポーティングサービスは柔軟で無料のオンデマンドフィードです。概要データや生データをリクエスト可能。場所、スケジュール、成功状態でフィルタリングできます。必要なフィールドだけを返します。

レポートタイプ
得られるもの
一般的な使用例
アカウント利用率
監視ソリューションごとの使用中および利用可能なリソース
ライセンスおよび容量計画、請求の照合
デバイスステータス
個別デバイスまたはセットの現在の状態およびステータス
ライブステータスページ、NOCウォールダッシュボード
レスポンス詳細
リクエストごとに高度にカスタマイズ可能なタイミングおよびコンテンツ
詳細な診断、カスタムウォーターフォール、インシデントの充実化
デバイスおよびタスク構成
エクスポートされた監視構成のスナップショット
バックアップ、クロス環境クローン、監査トレイル
概要データ
稼働時間、停止時間、成功回数、失敗回数、パフォーマンス、標準偏差
経営者向けサマリー、SLAレポート
生レスポンス
デバイスのすべてのチェック結果(最大6か月前まで)
法医学的分析、歴史的比較
時間ごとの集計
レスポンスデータを1時間単位で集計
ピーク負荷の特定、時間ごとのトレンド分析
日単位の集計
レスポンスデータを24時間単位で集計
日次業務レビュー、平日と週末の比較
週次/月次/年次
より長期の時間軸での要約
経営層向けトレンド分析、前年同期比パフォーマンスレポート
3か月統計
過去3か月のローリング期間で計算された統計データ
ベースラインに基づくアラート、異常検知

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

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

DevOps、SRE、プラットフォームエンジニアリング向けに構築

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

ドリフトの排除

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

監視をシフトレフトへ

対象サービスと同じPR内でシンセティックチェックを追加。監視が数週間後ではなくコードと共に導入されます。

クリックなしでスケールアップ

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

詳細なセキュリティ

短命のセッション、オプションのIPホワイトリスト、および部門単位の統合キーでアクセスを厳密に管理します。

あらゆるスタックに適合

プレーンHTTP + JSON(またはレポーティング用のGET + XML)。SDKのロックインなし。あらゆる言語とCI/CDツールで動作します。

データを所有する

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

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

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

追加費用なし

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

お客様の声

"Dotcomの優れた機能の一つは、ネットワークパフォーマンスデータを提供するプッシュ/プルAPI機能です。これを使用してパフォーマンス問題やページ読み込み統計を監視しています。Dotcom-Monitorにより、1つのインターフェースとプラットフォームで複数のサービスを監視でき、より効率的に運用できています。"
Gregory S.
マネージャー、放送メディア · 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アカウントでManage > Integrations > New Integrationに移動し、設定用のWeb API統合か、XRS用のXML Feed統合のいずれかを作成します。すべての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、Email、FTP、ICMP Ping、TCP Port、Traceroute、VoIPなど)。さらにLoadViewの負荷テスト全領域も含まれます。

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

XRSは最大6ヶ月前までの生レスポンスデータを返せます。サマリー及び統計レポート(時間別・日別・週別・月別・年別集計と3ヶ月統計)はより長期間にわたって利用可能です。レポートごとに開始日と終了日時を指定します。

はい — HTTPコールを行えるツールならAPIを操作できます。チームは一般的にJenkins、GitHub Actions、GitLab CI、Azure DevOps、CircleCI、Terraformと統合して、デプロイ時にモニターをプロビジョニングしたり、リリース後にスモークテストを実行したり、モニタリング健康状態による本番展開のゲートに利用しています。

はい。Web API統合を作成する際に、すべての認証リクエストからのアクセスを許可するか、信頼されたIPアドレスのリストにアクセスを制限するか選択できます。詳細はナレッジベースのHow to Whitelist IPs for Web API Access記事をご覧ください。

はい。ルートアカウントのユーザーはプログラム的に部門を管理でき、XML Feed統合は特定の部門に限定可能です。部門限定ユーザーは自部門のXRSレポートのみ取得できるため、MSPやマルチテナント構成の清潔な分離をサポートします。

完全なドキュメントはDotcom-Monitorナレッジベースにあり、Getting Started with the APIガイド、モニタリングおよびLoadViewメソッドリファレンス(JSON例付き)、およびXRSリクエストパラメータリファレンスが含まれます。使いやすいコードテンプレートもコード例セクションで利用可能です。

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

10,000以上の組織がDotcom-Monitorを使用して顧客より先に障害を検出し、APIとXRSを活用して管理を容易にしています。