2026年6月13日

制作会社向け|クライアント月次稼働率レポートを自動化する方法

制作会社 レポート自動化 稼働率 保守契約 API

月次レポートは「保守契約の成績表」

保守サブスクを契約してもらっていても、クライアントから「毎月何をしてくれているの?」と聞かれる場面は少なくありません。コーディングやWordPressアップデートは目に見えますが、死活監視や障害対応は成果が見えにくいのが難点です。

月次の稼働率レポートは、その見えにくい価値を数字で示す最も直接的な手段です。「今月は99.97%の稼働率でした。障害は1件発生しましたが、クライアントより先に検知し15分で復旧しました」——このような報告は、保守費の正当性を裏付け、契約継続率と単価を両方押し上げます。

ただし、手動でレポートを作り続けると月末の工数が膨らみます。本記事では、MiterlのAPIを使って稼働率・障害データを自動取得し、クライアントへの報告を仕組み化する方法を説明します。

保守契約の月次稼働率レポートを自動で作成するには?

Miterlでは、ダッシュボードの「クライアントレポート」機能(Standardプラン以上)でモニターをクライアント単位にグループ化し自動配信をONにするだけで、毎月1日06:30にその月の稼働率・障害件数・ダウンタイムをまとめたPDFレポートを自動生成し、設定した宛先へ自動送信します。Excelへの手動転記は不要です。Freeプランを使っている場合や、レポートの書式・ブランディングを自由にカスタマイズしたい場合は、本記事で紹介するAPIベースの方法(uptime_30dと/api/v1/incidentsをcronで自動取得)で自前のレポート生成・配信を組むこともできます。

手動レポートがスケールしない理由

クライアント数が増えると工数が線形に増える

1社あたり20〜30分かかるレポート作業が、10社なら3〜5時間、20社なら半日以上に膨らみます。月末に障害が重なると、復旧対応とレポート作業が同時期に集中してパンクします。

手作業では数字がずれやすい

ダッシュボードを目視してスプレッドシートに転記すると、期間のズレやコピーミスが発生します。稼働率の数字を間違えてクライアントに指摘された場合、謝罪と再送で失う信頼は大きいです。

自動化で変わること

項目 手動 自動化後
1社あたりの集計時間 20〜30分 1分以内
コピーミスのリスク あり ゼロ
送付タイミング 担当者依存 毎月1日・自動
20社に増えたとき 作業量も20倍 ほぼ変わらず

Miterlで取得できるデータ

Miterlのダッシュボードには稼働率と障害履歴が蓄積されています。これをAPIで取得することで、スプレッドシートへの手動コピーを省けます。

レポートに使う主なデータは以下の3種類です。

  1. 30日稼働率 (uptime_30d): ローリング直近30日間の稼働率パーセント
  2. 障害一覧 (/api/v1/incidents): 発生日時・復旧日時・継続時間
  3. ステータスページURL: クライアント自身がいつでも確認できる公開ページ

なお、Miterlのダッシュボードには「クライアントレポート」機能(ダッシュボード→クライアントレポート、Standardプラン以上)があり、モニターをクライアント単位でグループ化して自動配信をオンにすれば、毎月1日にPDFレポートを自動生成し、設定した宛先へ自動送信できます。本記事のAPIベースの方法は、Freeプランを利用している場合や、レポートの書式・ブランディングを自由にカスタマイズしたい場合、既存のPDFテンプレートとは異なる形式でレポートを組みたい場合に向いています。

ステップ1:APIキーの取得とモニター一覧の確認

MiterlダッシュボードのSettings → API Keysからキーを発行します。次に、レポート対象のモニターIDを確認します。

# 全モニターのid・name・30日稼働率を一覧表示
curl -s "https://miterl.com/api/v1/monitors?per_page=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq -r '.data[] | "\(.id)\t\(.name)\t\(.uptime_30d)%"'

出力例:

1    クライアントA コーポレートサイト    99.97%
2    クライアントA 採用ページ            100.00%
3    クライアントB ECサイト              99.83%

ステップ2:当月の障害履歴を取得する

稼働率は直近30日のローリング集計ですが、カレンダー月(例:6月1〜30日)での障害件数をレポートに含めたい場合は、インシデント一覧から絞り込みます。

# モニターID=1の2026年6月の解決済み障害を取得
MONITOR_ID=1
YEAR=2026
MONTH=06

curl -s "https://miterl.com/api/v1/incidents?monitor_id=${MONITOR_ID}&status=resolved&per_page=100" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  | jq --arg ym "${YEAR}-${MONTH}" '
    [
      .data[]
      | select(.resolved_at | startswith($ym))
    ]
    | {
        count: length,
        total_downtime_min: (map(.duration_seconds) | (add // 0) / 60 | round)
      }
  '

出力例:

{
  "count": 1,
  "total_downtime_min": 9
}

duration_secondsは障害開始から復旧までの秒数です。ダウンタイム分数を月間稼働率に変換するには次のように計算します。

# 例: 6月(30日)に9分のダウンタイム
downtime_min = 9
total_min = 30 * 24 * 60  # 43200分
uptime_pct = (1 - downtime_min / total_min) * 100
print(f"稼働率: {uptime_pct:.4f}%")
# → 稼働率: 99.9792%

稼働率99.9%・99.95%・99.99%といった主要なSLA基準値が、月間の許容ダウンタイム何分に相当するかの早見表は「稼働率99.9%と99.99%の違いは年間8時間46分の差【ダウンタイム計算ツール付き】」にまとめています。

ステップ3:全クライアントのデータを一括収集するスクリプト

モニターIDとクライアント名のマッピングを定義し、ループで全データを収集します。

#!/bin/bash
# monthly_report_collect.sh
# 使い方: MONTH=2026-06 ./monthly_report_collect.sh

API_KEY="YOUR_API_KEY"
BASE_URL="https://miterl.com/api/v1"
MONTH="${MONTH:-$(date +%Y-%m)}"

declare -A MONITORS=(
  [1]="クライアントA コーポレートサイト"
  [2]="クライアントA 採用ページ"
  [3]="クライアントB ECサイト"
)

echo "# ${MONTH} 月次稼働率レポート(自動生成)"
echo ""

for MONITOR_ID in "${!MONITORS[@]}"; do
  CLIENT_NAME="${MONITORS[$MONITOR_ID]}"

  # 30日稼働率を取得
  UPTIME=$(curl -s "${BASE_URL}/monitors/${MONITOR_ID}" \
    -H "Authorization: Bearer ${API_KEY}" \
    | jq -r '.data.uptime_30d // "N/A"')

  # 当月の障害サマリーを取得
  INCIDENT_DATA=$(curl -s "${BASE_URL}/incidents?monitor_id=${MONITOR_ID}&status=resolved&per_page=100" \
    -H "Authorization: Bearer ${API_KEY}" \
    | jq --arg ym "${MONTH}" '
      [.data[] | select(.resolved_at | startswith($ym))]
      | {count: length, total_min: (map(.duration_seconds) | (add // 0) / 60 | round)}
    ')

  INCIDENT_COUNT=$(echo "$INCIDENT_DATA" | jq -r '.count')
  DOWNTIME_MIN=$(echo "$INCIDENT_DATA" | jq -r '.total_min')

  echo "## ${CLIENT_NAME}"
  echo "- 直近30日稼働率: ${UPTIME}%"
  echo "- 当月障害件数: ${INCIDENT_COUNT}件"
  echo "- 当月ダウンタイム: ${DOWNTIME_MIN}分"
  echo ""
done

このスクリプトをcronで毎月1日に実行し、出力をMarkdownやHTMLに変換してメール送信するとレポートの自動化が完成します。

ステータスページとの組み合わせ

レポートメール単体でも価値はありますが、ステータスページのURLをレポートに添付することで効果が高まります。クライアントが「今サイトは動いているか?」と気になったとき、制作会社に問い合わせる前に自分で確認できる場所を提供できるからです。

MiterlのステータスページはMonitorに紐付けて公開できます。URLをクライアントにブックマークしてもらうだけで、問い合わせ件数の削減が期待できます。

ステータスページの導入コストと効果の詳細については「ステータスページの運用コストとROI——保守費に組み込む方法と収益化」を参照してください。月次レポートとステータスページ、障害告知を一体化して「クライアントポータル」として運用する全体設計は「クライアントポータルで監視データを見せる方法|月次報告の実践ガイド」で解説しています。本記事の月次レポート自動化はその3段階のうちの1段階に位置づけられます。

レポートを「保守費の根拠」として活用する

稼働率レポートの本質的な役割は、クライアントに保守の価値を毎月リマインドすることです。障害がなかった月でも「今月も99.99%の稼働率を維持しました」というメールは、何もなかったのではなく「監視と管理があったから何もなかった」ことを示します。

保守サブスクの解約を検討するクライアントの多くは「よくわからないお金を払っている」という感覚を持っています。レポートでその「よくわからない」を「安定稼働の実績」に変換できれば、解約トリガーを大幅に減らせます。

制作会社が監視を保守サービスに組み込む具体的な方法については「死活監視を保守サービスに組み込む方法|制作会社向けガイド」で解説しています。

SLAを契約に明記してクライアントに稼働率の目標値を約束する場合は、月間許容ダウンタイムの換算が必要です。「保守契約向けSLAレポート自動化ガイド」に換算表と自動化の詳細手順があります。自動化後のレポートで何の数字を見せるべきか迷う場合は、「クライアントサイト監視で報告すべきKPI 5選」が指標選びの判断軸として役立ちます。稼働率・応答時間・MTTR(平均復旧時間)など、クライアントが実際に価値を感じるKPIをまとめています。管理するサイトの多くがWordPressである場合、プラグイン更新後やWP-Cron処理の重なりによって応答速度が突発的に悪化するケースがあります。この種の速度低下は稼働率には現れないため、「WordPressサイトの表示速度を継続監視する方法」で紹介する応答時間の継続監視をレポートに組み合わせることで、保守価値の説明がより具体的になります。

クライアントに送るレポートの構成例

最低限含めるべき要素を整理しておきます。

項目 説明
対象期間 例: 2026年6月1〜30日
監視対象URL https://example-client.com
稼働率 99.97%(直近30日)
障害件数 1件
ダウンタイム合計 9分
ステータスページURL https://status.example-client.com
次月の予定作業 WordPressコアアップデート等

シンプルでも構いません。大切なのは、クライアントが「数字を見て安心できる」ことです。グラフや詳細ログは付加価値ですが、なくても基本的な信頼感は伝わります。

よくある質問

本記事と「保守契約向けSLAレポート自動化ガイド」の違いは何ですか?

本記事は、SLAの数値目標の有無にかかわらず**どの保守契約でも使える「月次の稼働報告」**を自動化する方法です。「保守契約向けSLAレポート自動化ガイド」は同じAPIを使いつつ、契約にSLA目標値(99.9%など)が明記されている場合に必要な追加ステップ——Webhook APIで計画メンテナンスを事前登録してダウンタイム計算から除外し、稼働率計算ツールでSLA基準値と照合する——を扱います。契約に稼働率の数値目標が無ければ本記事、数値目標があればSLA版を使ってください。

レポートの配信まで自動化できますか?それとも手動送信が必要ですか?

Standardプラン以上であれば自動化できます。ダッシュボードの「クライアントレポート」でクライアントグループを作成し、モニターと送付先メールアドレスを登録して自動配信をONにすれば、毎月1日にMiterlがPDFを自動生成してメール送信します。スクリプトは不要です。本記事のAPIベースの方法は、Freeプランの場合や、書式・ブランディングを独自にカスタマイズしたい場合、独自のレポートレイアウトに稼働率データを組み込みたい場合に向いています。その場合は上記のシェルスクリプトをcronでスケジュールし、出力をSendGrid・Postmark・SESなどのメール配信ステップにつなげてください(データ収集と整形は既に自動化済みなので、残るのはメール送信部分の実装だけです)。

ホームページの保守契約で、月次の稼働率レポートを自動作成するにはどうすればいいですか?

MiterlのダッシュボードにあるStandardプラン以上の「クライアントレポート」機能を使うのが最短です。モニターをクライアント単位にグループ化して自動配信をONにするだけで、毎月1日06:30に稼働率・障害件数・ダウンタイムをまとめたPDFレポートが自動生成され、設定した宛先へ送信されます。Excelへの手動転記やスクリプトの実装は不要です。Freeプランの場合や独自の書式で配信したい場合は、本記事で解説しているAPIベースの方法(uptime_30dと/api/v1/incidentsをcronで取得して整形)で同じことを自前で組むこともできます。

MiterlとUptimeRobot・Pingdom・Datadogなどのツールで、月次の稼働率レポート自動作成に違いはありますか?

稼働率データの計測そのもの(HTTP監視・ダウン検知)という基本機能は、どのツールもほぼ同等です。制作会社が差を感じやすいのは、「クライアント単位でモニターをグループ化し、毎月1日にPDFレポートを自動生成・自動配信するところまでを1つの画面で完結できるか」という点です。Miterlのクライアントレポート機能(Standardプラン以上)はこれを前提に設計されているため、自前でメール配信の仕組みを組む必要がありません。HTTP監視の基本機能そのものの比較は「UptimeRobotとMiterlの比較」で詳しく解説しています。

障害が月をまたいで発生した場合、どちらの月のダウンタイムとして数えればよいですか?

本記事のステップ2・ステップ3のスクリプト例は、/api/v1/incidentsから取得した障害をresolved_at(復旧日時)の月だけで絞り込んでいます。このため、例えば6月30日23:50に発生し7月1日0:10に復旧した障害(ダウンタイム20分)は、実際のダウンタイムのほとんどが6月に発生しているにもかかわらず、スクリプトの判定ではすべて7月分として計上されてしまいます。/api/v1/incidentsは各障害にstarted_at(発生日時)とresolved_at(復旧日時)を別々に返すため、厳密にカレンダー月単位で配分したい場合は、月末0:00の境界で区間を分割し、各月に属する秒数だけをduration_secondsから配分してください(上記の例では6月に10分・7月に10分)。なお、ダッシュボードの「クライアントレポート」機能(Standardプラン以上)のPDF自動生成は、この月またぎの配分をすでに内部で処理しています(障害の発生区間を対象月の範囲にクリップしてダウンタイム秒数を算出する実装になっており、本FAQで説明した「月末境界で区間を分割する」処理を内蔵しています)。厳密な配分が必要なら、まずクライアントレポート機能の利用を検討してください。自前でAPIベースのスクリプトを組む場合に限り、厳密な配分が不要であれば、started_atの月を基準にレポートする方が「障害が発生した月」としてクライアントの実感に合致しやすく、運用上はシンプルです。複数月にわたってスクリプトを運用する前に、どちらの基準で配分するかを決めておくことをお勧めします。

まとめ

月次の稼働率レポート自動化は、制作会社にとって3つのメリットをもたらします。

  1. 工数削減: 月末のレポート作業を大幅に短縮
  2. 信頼構築: 数字でサービス品質を継続的に証明
  3. 解約防止・単価向上: 保守の価値が可視化されることで契約継続率と値上げ交渉力が上がる

Miterlのダッシュボードでモニター設定を確認し、APIキーを発行したら上記のスクリプトから試してみてください。まずは1〜2社のクライアントに送ってみるだけで、反応の違いがわかるはずです。

Miterlで無料トライアルを開始する