監視タイプ

B-Beacon は11種類の監視方式（Web外形監視・サーバー内部エージェント・データベース・Heartbeat・ネットワーク）をサポートしています。それぞれの特徴と設定方法を説明します。

1. HTTP(S) モニター

指定した URL に HTTP リクエストを送信し、レスポンスのステータスコードと応答時間を監視します。Web サイトや API の死活・性能監視に最適です。

設定項目

2. SSL 証明書モニター

SSL/TLS 証明書の有効期限を監視し、期限切れによる接続エラーを未然に防ぎます。

設定項目

3. TCP モニター

指定したホストとポートに TCP 接続を試行し、ポートの疎通を確認します。Web 以外のサーバーや独自プロトコルの監視に使用します。

設定項目

4. DNS モニター

ドメインの名前解決を監視し、DNS レコードの消失や意図しない変更を検知します。

設定項目

5. データベース モニター

MySQL, MariaDB, PostgreSQL, SQL Server に直接接続して死活とパフォーマンスを監視します。

設定項目

6. Redis モニター

Redis サーバーに接続して PING 応答とメモリ使用状況を監視します。

設定項目

7. Heartbeat（Push型）モニター

外部からのポート開放が一切不要な Push 型監視です。Cron ジョブ、夜間バックアップ、ディスク容量監視などから B-Beacon の専用 URL へ定期的に HTTP リクエストを送信し、連絡が途絶えた瞬間に障害を検知します。

仕組み

1. B-Beacon で Heartbeat モニターを作成すると、専用のエンドポイント URL（https://getbbeacon.com/api/heartbeat/TOKEN）が発行されます。
2. 監視対象のサーバーやバッチ処理から、この URL に定期的にリクエスト（GET または POST）を送信します。
3. 設定した猶予期間（秒）を超えてもリクエストが届かない場合、直ちに「ダウン（Down）」と判定してアラートを発報します。

コピペで使えるスクリプト例

(1) 定期バッチ（Cron ジョブ）の生存監視

ジョブが正常終了したときだけ末尾の curl が実行されます：

0 3 * * * /usr/bin/php /var/www/app/artisan batch:run && curl -fsS -m 10 "https://getbbeacon.com/api/heartbeat/YOUR_TOKEN" > /dev/null

(2) DB バックアップ生存監視スクリプト（Bash）

バックアップ処理が成功した時のみシグナルを送信し、エラー時は停止して障害を通知します：

#!/bin/bash
set -eo pipefail

HEARTBEAT_URL="https://getbbeacon.com/api/heartbeat/YOUR_TOKEN"

# 1. バックアップ処理を実行
mysqldump -u root -p'PASSWORD' my_db | gzip > /var/backups/db_$(date +%Y%m%d).sql.gz

# 2. 成功時のみ B-Beacon へ送信
curl -fsS -m 10 "$HEARTBEAT_URL" > /dev/null

(3) ディスク容量パンク防止スクリプト

使用率が 90% 未満なら正常シグナルを送り、90% を超えたら送信を止めてアラートを発報させます：

#!/bin/bash
HEARTBEAT_URL="https://getbbeacon.com/api/heartbeat/YOUR_TOKEN"
THRESHOLD=90

USAGE=$(df / | awk 'NR==2 {print $5}' | sed 's/%//')
if [ "$USAGE" -lt "$THRESHOLD" ]; then
    curl -fsS -m 10 "$HEARTBEAT_URL" > /dev/null
else
    echo "Disk usage critical: ${USAGE}%" >&2
fi

8. ドメイン有効期限 モニター

ドメインの登録有効期限日（失効日）を自動取得し、更新忘れによるWebサイト消滅を未然に防ぎます。ICANN 標準の RDAP および Whois プロトコルに対応しています。

設定項目

9. ICMP Ping モニター

純粋な ICMP Echo リクエストにより、サーバーやルーター、ネットワーク機器の死活・パケットロス率・平均応答時間（RTT）を監視します。

設定項目

10. UDP ポート モニター

DNS（53番）や NTP（123番）など、UDP プロトコルを使用するサービスのポート疎通を確認します。

設定項目

11. サーバー監視（Agent）モニター

「世界一簡単なホスト監視」。Linux サーバーに 1 行のコマンドを実行するだけで、ディスク容量パンク（90%超・95%超）、メモリ枯渇、CPU ロードアベレージ、指定プロセス死活 を毎分全自動で監視します。

ワンライナーでの導入手順

1. B-Beacon 管理画面で「モニター」>「新規作成」を開き、タイプに 「サーバー(Agent)」 を選択して作成します。
2. モニター詳細画面に表示された 1行のインストールコマンド をコピーします：

curl -fsSL https://getbbeacon.com/agent/install.sh | bash -s -- YOUR_TOKEN

3. 監視対象のサーバー（SSH ターミナル）に貼り付けて実行します。これだけでセットアップ完了です。

監視・検知される項目

ワンライナーコマンドの動作と安全性

セキュリティ規程の厳しい法人環境でも安心してご利用いただけるよう、ワンライナーは極めてシンプルかつ安全に設計されています：

• 実行前の事前監査が可能: スクリプト実行前に curl -fsSL https://getbbeacon.com/agent/install.sh | less で全コードを確認できます。
• SHA-256 完全性検証（改ざん防止）: 以下のコマンドでチェックサムを照合してから実行できます：

  curl -fsSL https://getbbeacon.com/agent/install.sh -o /tmp/install.sh
  echo "cfb729278dde36182370cf73b9e986427047aeacff5c8a7591338e5da223058e  /tmp/install.sh" | sha256sum -c
  bash /tmp/install.sh YOUR_TOKEN

• root 権限不要: 一般ユーザーで動作し、システム領域（/etc や /usr 等）への書き込みは一切行いません。
• 追加パッケージのインストールゼロ: OS 標準の bash, curl, df, free のみを使用します。
• 配置場所: 実行ユーザーの ~/.bbeacon/ 配下にスクリプトと専用トークン（パーミッション 600 で他ユーザー閲覧不可）を配置します。
• トークンの失効・再発行（Revoke）: 管理画面のモニター設定からいつでもトークンを再発行（旧トークンは即時無効化）できます。
• Cron 実行: ユーザーの crontab に * * * * * ~/.bbeacon/agent.sh >/dev/null 2>&1 を追加し、毎分1回実行します（Linux 1vCPU環境での実測実行時間は約0.04〜0.08秒、常駐デーモン不要のためアイドル時CPU負荷は実質ゼロです）。
• アンインストール: 不要になった場合は ~/.bbeacon/uninstall.sh を実行するだけで、Cron 解除とファイル削除が1秒で完了します。

独自スクリプトによる実装（REST API 仕様 & 多言語ガイド）

ワンライナーを使用せず、既存の社内バッチや CI/CD、独自監視スクリプト、コンテナから直接メトリクスを送信することも可能です。

REST API 仕様

// リクエスト JSON 例
{
  "disk": {
    "usage_percent": 45,
    "free_gb": 52.3,
    "total_gb": 100.0
  },
  "memory": {
    "usage_percent": 62,
    "free_mb": 1500,
    "total_mb": 4000
  },
  "cpu": {
    "load_1m": 0.15,
    "load_5m": 0.22
  },
  "processes": {
    "nginx": true,
    "mysqld": true,
    "php-fpm": true
  }
}

多言語コードスニペット

#!/usr/bin/env bash
TOKEN="YOUR_TOKEN"
DISK=$(df -Pk / | awk 'NR==2 {print $5}' | tr -d '%')
MEM=$(free -m | awk '/Mem:/ {printf "%d", ($3/$2)*100}')

curl -fsS -X POST "https://getbbeacon.com/api/v1/agent/report" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d "{\"disk\":{\"usage_percent\":$DISK},\"memory\":{\"usage_percent\":$MEM}}"

<?php
$token = 'YOUR_TOKEN';
$url = 'https://getbbeacon.com/api/v1/agent/report';

$diskTotal = disk_total_space('/');
$diskFree = disk_free_space('/');
$diskUsage = round((($diskTotal - $diskFree) / $diskTotal) * 100);

$payload = json_encode([
    'disk' => [
        'usage_percent' => $diskUsage,
        'free_gb' => round($diskFree / 1024 / 1024 / 1024, 1),
    ],
]);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 5,
]);
curl_exec($ch);
curl_close($ch);

const os = require('os');
const { execSync } = require('child_process');

const TOKEN = 'YOUR_TOKEN';
const URL = 'https://getbbeacon.com/api/v1/agent/report';

let diskUsage = 0;
try {
  const df = execSync('df -Pk /').toString();
  diskUsage = parseInt(df.trim().split('\n')[1].split(/\s+/)[4].replace('%', ''), 10);
} catch (e) {}

const memUsage = Math.round(((os.totalmem() - os.freemem()) / os.totalmem()) * 100);

fetch(URL, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${TOKEN}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    disk: { usage_percent: diskUsage },
    memory: { usage_percent: memUsage },
    cpu: { load_1m: os.loadavg()[0] },
  }),
}).catch(console.error);

import json, shutil, urllib.request, os

TOKEN = 'YOUR_TOKEN'
URL = 'https://getbbeacon.com/api/v1/agent/report'

total, used, free = shutil.disk_usage('/')
disk_usage = round((used / total) * 100)

payload = json.dumps({
    'disk': {'usage_percent': disk_usage, 'free_gb': round(free / (1024**3), 1)},
    'cpu': {'load_1m': os.getloadavg()[0]},
}).encode('utf-8')

req = urllib.request.Request(
    URL,
    data=payload,
    headers={'Authorization': f'Bearer {TOKEN}', 'Content-Type': 'application/json'}
)
urllib.request.urlopen(req, timeout=5)

チェック間隔とプラン制限

監視のチェック間隔と登録可能モニター数は、ご契約プランによって異なります。

監視方式別 検知可能範囲・制約マトリクス

各監視方式がカバーする障害範囲と、アーキテクチャ上の制約事項の一覧です。システムの特性に応じて適切な監視方式を組み合わせてご利用ください。