OpenMetrics サポート環境
OpenAgentはPrometheus / OpenMetrics形式を公開するエンドポイントであれば、言語やフレームワークに関係なく収集できる**言語非依存（Language-Agnostic）**エージェントです。Goでコンパイルされた単一バイナリとして提供され、別途ランタイムをインストールせずにLinuxホストまたはKubernetesクラスターで実行できます。
本ドキュメントはOpenAgentが公式にサポートするオペレーティングシステム、Kubernetesバージョン、スクレイピング対象、ネットワーク 要件などを整理します。
エージェントの実行形態
| Platform | Support | Note |
|---|---|---|
| 単一バイナリ（Linux） | ✅ | AMD64 / ARM64 |
| Windows ネイティブバイナリ | ❌ | 未サポート |
| macOS（Apple Silicon） | ❌ | 未サポート |
別途ランタイム要件
OpenAgentはGoでビルドされた静的バイナリのため、JVM、Node.js、Pythonなどのランタイムを別途インストールする必要はありません。
オペレーティングシステム（OS）
Linux
| Architecture | Support | Download URL |
|---|---|---|
| x86_64 / AMD64（Intel、AMD 64ビット） | ✅ | https://repo.whatap.io/openagent/latest/amd/openagent |
| ARM64 / AArch64（Linux ARMプロセッサー） | ✅ | https://repo.whatap.io/openagent/latest/arm/openagent |
| x86（32ビット） | ❌ | - |
ディストリビューション互換性
glibcベースの主要Linuxディストリビューションで動作します。
| Distribution | Version |
|---|---|
| Red Hat Enterprise Linux / CentOS / Rocky / AlmaLinux | 7.x 以上 |
| Ubuntu | 18.04 LTS 以上 |
| Debian | 10 以上 |
| Amazon Linux | 2 / 2023 |
| SUSE Linux Enterprise Server | 12 以上 |
未サポートプラットフォーム
- Windows（Windows Server含む）
- macOS（IntelおよびApple Silicon）
- FreeBSD、OpenBSDなどその他のUnix系
コンテナ環境
Docker
| Platform | Support |
|---|---|
| Docker Engine 20.x 以上 | ✅ |
| containerd 1.6 以上 | ✅ |
| CRI-O | ✅ |
スクレイピング対象（Exporter）
OpenAgentはPrometheus /metricsエンドポイントを公開するすべてのExporterおよびアプリケーションを収集できます。
サポートメトリクス形式
| Format | Support | Note |
|---|---|---|
| Prometheus Exposition Format（text） | ✅ | デフォルト |
| OpenMetrics Text Format | ✅ | application/openmetrics-text |
| Protobuf | ❌ | 未サポート |
代表的なサポートExporter（例）
| Category | Exporter |
|---|---|
| システム / ホスト | node_exporter、windows_exporter |
| Kubernetes | kube-state-metrics、kubelet、cAdvisor、kube-apiserver |
| データベース | mysqld_exporter、postgres_exporter、redis_exporter、mongodb_exporter |
| メッセージキュー | kafka_exporter、rabbitmq_exporter |
| Webサーバー | nginx-prometheus-exporter、apache_exporter |
| GPU / AI | dcgm-exporter（NVIDIA） |
| クラウド | cloudwatch_exporter、azure_metrics_exporter |
| アプリケーション | Spring Boot Actuator、Micrometer、OpenTelemetry Collector |
表にないExporterもPrometheus テキスト形式 に従っていれば、ほとんど収集できます。
ターゲットディスカバリー方式
| Type | Description | Environment |
|---|---|---|
| StaticEndpoints | 固定IP:PORTの直接指定 | ホスト / Kubernetes共通 |
| PodMonitor | Podラベルセレクターに基づく動的ディスカバリー | Kubernetes |
| ServiceMonitor | Serviceラベルセレクターに基づく動的ディスカバリー | Kubernetes |
システムリソース要件（推奨）
| Item | Minimum | Recommended |
|---|---|---|
| CPU | 0.1コア | 0.5コア以上 |
| Memory | 128 MB | 256 MB以上 |
| Disk | 1 GB（ログ含む） | 5 GB以上 |
測定基準: エンドポイント10個、エンドポイントあたり約100タイムシリーズ（合計約1,000タイムシリーズ）、収集周期60秒。この基準での実測使用量はCPU平均0.003コア、メモリ約50 MBです。最小仕様はバーストおよび増設余裕を考慮した保守 的な値です。
エンドポイント数による実測使用量
同一Exporter（エンドポイントあたり83タイムシリーズ）を収集周期60秒でスクレイピングしながら、エンドポイント数を増やして測定した結果です。
| エンドポイント数 | 総タイムシリーズ / 分 | CPU平均 | Memory (RSS) |
|---|---|---|---|
| 1 | 83 | 0.002コア | 約31 MB |
| 10 | 830 | 0.003コア | 約52 MB |
| 100 | 8,300 | 0.010コア | 約70 MB |
スケールガイド
- リソース使用量はエンドポイント数ではなく総タイムシリーズ数に比例します。総タイムシリーズ約1万個（例: エンドポイント100個 × 100タイムシリーズ、60秒周期）のレベルまで最小仕様内で動作します。
node_exporter、kube-state-metricsのようにエンドポイントあたりのタイムシリーズが数千個の場合、エンドポイント数ではなく総タイムシリーズ数 基準で換算してください。- 収集周期を短くすると（例: 60秒 → 15秒）、同じタイムシリーズ数に対してCPU使用量が比例して増加します。
- 数百個以上のターゲットを収集したり、高カーディナリティExporterを収集する環境ではCPU/Memoryのスペックを引き上げる必要がある場合があります。
CPU推奨値（0.5コア）について
平均CPU使用量は低いですが（約0.003コア）、推奨値を0.5コア以上とする理由はバーストのためです。スクレイピング時点にすべての収集対象へのリクエスト・パーシングが同時に集中し、Kubernetesでlimits.cpuを0.1コアに制限するとこのバーストがスロットリングされ、スクレイピング遅延・タイムアウトが発生する可能性があります。そのため、requests.cpuが0.1コアであってもlimits.cpuは0.5コア以上を推奨します。
共通サポート環境
サービス提供形態
WhaTapモニタリングは、SaaSまたはオンプレミス（インストール型）方式でご利用いただけます。どちらを選択しても、同じエージェントで同じモニタリング機能をご利用いただけます。
| Deployment | Support | Description |
|---|---|---|
| SaaS | ✅ | WhaTapが運用する収集サーバーに接続。リージョン別アドレスはファイアウォール項目を参照 |
| オンプレミス（インストール型） | ✅ | 収集サーバーを自社で構築して運用（閉域網環境に対応）。導入範囲は営業担当者と協議 |
インターネットに接続しない閉域網環境でも、オンプレミスで構築できます。
提供形態による機能の違い
どの形態を選択しても、モニタリング機能は同じです。モバイルアプリのみが例外で、service.whatap.io SaaSでのみご利用いただけます。
オンプレミス環境で一部の機能をご利用いただくには、別途契約が必要です。
対応ブラウザ
WhaTapモニタリングサービスは、ウェブブラウザとモバイルアプリで利用できます。
| Webブラウザ | 推奨 | 対応バージョン |
|---|---|---|
| Google Chrome | ✅ | 111以降 |
| Mozilla FireFox | ❌ | 最新バージョン |
| Edge | ❌ | 最新バージョン |
| Safari | ❌ | 最新バージョン |
サポート案内
- ブラウザの互換性および性能の観点から、Chrome の最新バージョンの使用を推奨します。
- ユーザーインターフェース（User Interface, UI）は HTML5 標準技術で実装されているため、Internet Explorer はサポートしていません。
制約事項
WhaTap の Web インターフェースはモバイルブラウザをサポートしていません。モバイル端末から WhaTap にアクセスするには、Android または iOS 用の WhaTap アプリをインストールしてください。WhaTap モバイルアプリはモバイル環境に最適化されています。WhaTap モバイルアプリの詳細については、こちらのドキュメント を参照してください。
ファイアウォール
WhaTap エージェントは、収集サーバーの TCP 6600 ポートにアクセスできる必要があります。監視対象に最も近い収集サーバーのアドレスを許可してください。
出発地：WhaTapエージェント
| クラウド | 目的地 | 目的地IP | ポート番号 |
|---|---|---|---|
| AWS | WhaTapソウル収集サーバー | 13.124.11.223 / 13.209.172.35 | TCP 6600 |
| WhaTap東京収集サーバー | 52.68.36.166 / 52.193.60.176 | TCP 6600 | |
| WhaTapシンガポール収集サーバー | 18.138.0.93 / 18.139.67.236 | TCP 6600 | |
| WhaTapジャカルタ収集サーバー | 108.136.91.69 / 108.137.158.44 | TCP 6600 | |
| WhaTapタイ収集サーバー | 43.209.109.219 / 43.209.48.86 | TCP 6600 | |
| WhaTapムンバイ収集サーバー | 13.127.125.69 / 13.235.15.118 | TCP 6600 | |
| WhaTapカリフォルニア収集サーバー | 52.8.223.130 / 52.8.239.99 | TCP 6600 | |
| WhaTapバージニア収集サーバー | 107.23.220.101 / 54.236.221.105 | TCP 6600 | |
| WhaTapフランクフルト収集サーバー | 3.125.142.162 / 3.127.76.140 | TCP 6600 | |
| Azure | WhaTapソウル収集サーバー | 52.231.66.38 / 20.194.5.115 | TCP 6600 |
| WhaTap東京収集サーバー | 52.246.169.54 / 20.210.27.232 | TCP 6600 | |
| Kakao | WhaTapソウル収集サーバー | 61.109.237.237 / 61.109.238.166 | TCP 6600 |
インバウンド遮断ポリシーを使用する場合は、応答トラフィックを確認します。
エージェントが収集サーバーへ接続を開始するため、エージェントホストでインバウンドの6600ポートを開放する必要はありません。ただし、収集サーバーが送る応答パケットはエージェントホストに届く必要があります。インバウンドポリシーで、すでに確立されたセッションの応答トラフィック（established、related）まで遮断していないかを確認します。
応答トラフィックを遮断しなければならない場合は、例外を一つ設定します。収集サーバーIPの6600ポートからエージェントホストのエフェメラルポート範囲へ入るトラフィックのみを許可します。
エー ジェントから収集サーバーに直接接続できない場合は、提供するProxyモジュールを使用して経由します。
