Contents
1️⃣ 無料トライアルの開始とアカウント作成
1-1. サインアップ手順の概要
Grafana Cloud はクレジットカード不要で数分以内に利用開始できます。本セクションでは、公式サイトの 「Start for free」 ボタンを起点にした標準的なフローを解説します。アカウント取得後はすぐに UI が表示され、ダッシュボード作成やデータ送信テストが可能です。
- 公式トップ( https://grafana.com/ja/products/cloud/ )右上の Start for free をクリック
- メールアドレス・パスワードを入力し、届いた認証リンクでメール認証
- 「Create Workspace」画面で好きなワークスペース名とリージョンを選択し Create
これだけで Grafana Cloud の管理コンソールにログインでき、Free プランのリソースが自動的に割り当てられます。
1-2. Free プランの主要制限(2024 年版)
公式ドキュメント https://grafana.com/docs/grafana-cloud/free-plan/ に基づき、2024 年 11 月時点での無料プラン上限は以下の通りです。商用利用や大規模データ収集を検討している場合は、有料プランへの移行計画を早めに立てましょう。
| 項目 | 無料プラン上限 |
|---|---|
| メトリクス保持期間 | 14 日 |
| ログ・トレース保持期間 | ログ 14 日、トレース 7 日 |
| 月間データ転送量(概算) | メトリクス 10 M データポイント、ログ 50 GB、トレース 5 M スパン |
| エージェント台数 | 最大 3 台(Kubernetes DaemonSet 含む) |
| サポート | コミュニティフォーラムのみ |
ポイント:Free プランは評価・PoC に最適です。制限を把握したうえで、必要に応じて Standard 以上へのスムーズな移行手順をあらかじめ準備しておくと、本番導入時の障壁が低減します。
2️⃣ ワークスペース(スタック)作成と基本設定
2-1. スタックとは何か
Grafana Cloud では 「スタック」 単位でリソースを管理します。1 スタックは Prometheus、Loki、Tempo、Pyroscope のフルセットが自動的に用意され、リージョンごとに分離されたテナントとして機能します。
2-2. リージョン選択と通知チャネルの設定手順
リージョンはデータ転送レイテンシや法令遵守に直結するため、プロジェクト拠点に合わせて US、EU、APAC のいずれかを選びます。
- コンソール左メニュー → Stacks → Create stack
- 「Region」ドロップダウンで目的のリージョンを選択
- 必要に応じてスタック名・説明文を入力し Create
通知チャネルの追加(H3)
通知は Settings > Notification channels から設定できます。代表的なチャネルと設定手順は次の通りです。
| チャネル | 設定ポイント |
|---|---|
| Slack Webhook | URL を貼付し、テストメッセージで到達確認 |
| Microsoft Teams | 同様に Incoming Webhook の URL を登録 |
| 送信元アドレスと受信者リストを入力 |
注意:各チャネルは必ず「テスト通知」ボタンで動作確認してください。障害時のアラートが届かないと、迅速な復旧ができません。
3️⃣ Grafana Agent のインストールと構成例
3-1. 共通前提条件
- Linux カーネル 4.14 以上(Docker / K8s 両方可)
- outbound 通信が以下エンドポイントへ許可されていること(ポートは後述)
- API キーは 「Metrics Write」、「Logs Write」、「Traces Write」 の最小権限で作成し、環境変数
GRAFANA_API_KEYとして注入
3-2. Kubernetes DaemonSet デプロイ(H3)
K8s クラスタにエージェントを常駐させる最も手軽な方法です。以下のマニフェストは公式 One‑Click ガイドと同等ですが、ConfigMap に外部化した agent.yaml を参照しています。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
apiVersion: apps/v1 kind: DaemonSet metadata: name: grafana-agent namespace: monitoring spec: selector: matchLabels: app: grafana-agent template: metadata: labels: app: grafana-agent spec: containers: - name: agent image: grafana/agent:v0.38.2 args: - --config.file=/etc/agent/agent.yaml volumeMounts: - name: config mountPath: /etc/agent volumes: - name: config configMap: name: grafana-agent-config |
ConfigMap(grafana-agent-config)例
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
apiVersion: v1 kind: ConfigMap metadata: name: grafana-agent-config namespace: monitoring data: agent.yaml: | server: log_level: info prometheus: wal_directory: /tmp/wal global: scrape_interval: 15s configs: - name: default remote_write: - url: https://prometheus-prod-10-prod-us-east-0.grafana.net/api/prom/push basic_auth: username: <instance-id> password: ${GRAFANA_API_KEY} loki: positions_directory: /tmp/positions configs: - name: default clients: - url: https://logs-prod-us-east-0.grafana.net/api/prom/push basic_auth: username: <instance-id> password: ${GRAFANA_API_KEY} tempo: receivers: otlp: protocols: http: endpoint: 0.0.0.0:4318 remote_write: - url: https://traces-prod-us-east-0.grafana.net/api/prom/push basic_auth: username: <instance-id> password: ${GRAFANA_API_KEY} pyroscope: scrapes: - job_name: "app" static_configs: - targets: ["localhost:4040"] remote_write: - url: https://profiles-prod-us-east-0.grafana.net/api/v1/write basic_auth: username: <instance-id> password: ${GRAFANA_API_KEY} |
3-3. Linux バイナリ・Docker でのインストール(H3)
| 方法 | 手順概要 |
|---|---|
| Linux バイナリ | curl -L https://dl.grafana.com/agent/release/grafana-agent-linux-amd64.tar.gz | tar zx && sudo mv grafana-agent /usr/local/bin/ → /etc/systemd/system/grafana-agent.service を作成し、ExecStart=/usr/local/bin/grafana-agent --config.file=/etc/agent.yaml として有効化 |
| Docker | docker run -d --name=grafana-agent -e GRAFANA_API_KEY=xxxxx -v /path/to/agent.yaml:/etc/agent.yaml grafana/agent:latest --config.file=/etc/agent.yaml |
どちらの方法でも、先述の agent.yaml を共通化すれば Prometheus・Loki・Tempo・Pyroscope へのフルスタック送信が可能です。
まとめ:インフラに合わせて K8s DaemonSet、Linux バイナリ、Docker のいずれかを選択し、同一構成ファイルで統一的にデータを送信できる点が Grafana Agent の大きな利点です。
4️⃣ データ送信エンドポイントと Quickstart ガイドの活用
4-1. 各種データ種別の送信先エンドポイント(US リージョン例)
以下は公式 Quickstart ドキュメントに記載されている、最小構成で利用できるエンドポイントです。リージョンが異なる場合は us-east-0 の部分を対象リージョンに置き換えてください。
| データ種別 | エンドポイント URL | 推奨ポート |
|---|---|---|
| メトリクス (Prometheus) | https://prometheus-prod-10-prod-us-east-0.grafana.net/api/prom/push |
9090 |
| ログ (Loki) | https://logs-prod-us-east-0.grafana.net/api/prom/push |
3100 |
| トレース (Tempo) | https://traces-prod-us-east-0.grafana.net/api/prom/push |
4318 |
| プロファイル (Pyroscope) | https://profiles-prod-us-east-0.grafana.net/api/v1/write |
4040 |
4-2. Quickstart ガイドのリンク集(重複排除)
公式サイトの Quickstart セクションは各データ種別ごとに個別ページが用意されています。以下のリンクから直接参照してください。
| データ種別 | Quickstart リンク |
|---|---|
| メトリクス (Prometheus) | https://grafana.com/docs/grafana-cloud/quickstart/prometheus/ |
| ログ (Loki) | https://grafana.com/docs/grafana-cloud/quickstart/loki/ |
| トレース (Tempo) | https://grafana.com/docs/grafana-cloud/quickstart/tempo/ |
| プロファイル (Pyroscope) | https://grafana.com/docs/grafana-cloud/quickstart/pyroscope/ |
4-3. API キー管理のベストプラクティス(H3)
- 最小権限:
Metrics Write、Logs Write、Traces Writeのみ作成し、読み取り権限は付与しない。 - 環境変数注入:Docker/K8s では
GRAFANA_API_KEY、Linux サービスでは/etc/default/grafana-agentに記載する。 - ローテーション:90 日ごとに新しいキーを発行し、古いキーは即削除。自動化スクリプトで定期的にチェックすると安心です。
ポイント:キー漏洩や権限過剰付与はセキュリティリスクの元です。上記手順を必ず守り、CI/CD パイプラインからも直接参照しないようにしてください。
5️⃣ AI 機能とコスト最適化
5-1. Grafana Assistant(ダッシュボード自動生成)
2024 年リリースの Grafana Assistant は自然言語で質問すると、対象メトリクスの PromQL を生成し即座にパネルを作成します。例:
「CPU 使用率が 80 % 超えたときの過去 7 日間のトレンド」 → Assistant が avg(rate(node_cpu_seconds_total{mode="idle"}[5m])) 等のクエリとグラフパネルを自動配置。
また、異常検知時に RCA Workbench を呼び出すことで、メトリクス・ログ・トレースを横断検索し相関度の高い要因を提示します。
5-2. Adaptive Telemetry によるコスト自動最適化(H3)
Adaptive Telemetry はリアルタイムで送信データ量を監視し、サンプリングレートや保持期間を自動的に調整します。設定手順は次のとおりです。
- スタック → Settings > Adaptive Telemetry を有効化
- 「対象データ種別」から Metrics / Logs / Traces を選択
- 以下のパラメータをビジネス要件に合わせて設定
- 最小保持期間(例:ログ 30 日)
- サンプリング上限(例:1 分あたり 10 KB 超過時は 50 % ダウンサンプリング)
有効化すると、Free プランの月間転送上限に近づいた際に自動でサンプルレートが下げられ、予期せぬ課金リスクを低減できます。
6️⃣ 有料プラン(Standard)との比較とアップグレード手順
| 項目 | Free プラン | Standard(有料) |
|---|---|---|
| メトリクス保持期間 | 14 日 | 90 日 |
| ログ・トレース保持期間 | ログ 14 日、トレース 7 日 | ログ/トレース 30 日(プラン別に上限拡張可) |
| 月間データ転送量上限 | メトリクス 10 M ポイント、ログ 50 GB、トレース 5 M スパン | 実質無制限(プランごとに上限あり) |
| サポート | コミュニティフォーラムのみ | E‑mail + SLA(24 h) |
| AI 機能 | Grafana Assistant 基本版 | Advanced AI(自動 RCA 拡張・カスタムプロンプト) |
| スロットリング制御 | なし(上限超過でドロップ) | カスタムスロットリング設定可能 |
アップグレード時の留意点
-
データ保持ポリシーの見直し
有料プランではストレージコストが増えるため、不要なログや古いトレースは Retention Policy で自動削除する設定を推奨。 -
API キー権限再確認
標準以上のキーは書き込みだけでなく読み取り権限も付与できるため、最小権限の原則に基づき新規キーを発行し直す。 -
請求アラート設定
Settings → Billing で「予算超過アラート」を設定すると、コスト増加を即座に検知できます。
7️⃣ 導入後の運用チェックリスト
| 項目 | 確認方法 |
|---|---|
| エージェント接続状態 | grafana-agent status → “connected: true” が表示されるか |
| データ欠損の有無 | Grafana ダッシュボードで最新 1 時間分のメトリクス/ログが可視化されているか |
| 認証エラー | スタック → API Keys ページでキー有効期限と権限を点検 |
| ポート開放 | telnet <endpoint> <port> で通信がブロックされていないか確認 |
| Adaptive Telemetry 動作 | Settings > Adaptive Telemetry のレポートにサンプリング率変化が記録されているか |
| AI 機能利用状況 | Assistant のリクエスト数と成功率をモニタリング(Settings > Usage) |
上記項目は 導入直後 と 1 週間ごと に実施し、異常があれば公式トラブルシューティング (https://grafana.com/docs/grafana-cloud/troubleshooting/) を参照して対処してください。
📚 まとめ ― Grafana Cloud 活用の要点
| 項目 | 要点 |
|---|---|
| 無料トライアル | クレジットカード不要で数分完了。Free プランは評価・PoC に十分なリソースが提供される。 |
| スタック設計 | リージョン選択と通知チャネル設定を最初に済ませることで、障害時のアラート配信が確実になる。 |
| エージェント導入 | K8s DaemonSet・Linux バイナリ・Docker のいずれでも同一 agent.yaml でフルスタック送信可能。 |
| Quickstart 活用 | エンドポイント URL と API キー管理を正しく行えば、設定ミスはほぼ防げる。 |
| AI & コスト最適化 | Grafana Assistant がダッシュボード作成工数を削減し、Adaptive Telemetry が予算超過リスクを自動抑制する。 |
| 有料プラン移行 | データ保持期間・サポート体制が大幅に拡張される。アップグレード時はキー権限とストレージ削除ポリシーを見直すこと。 |
| 運用チェック | エージェント接続、データ欠損、ポート開放、Adaptive Telemetry の 5 点を定期的に検証するだけで安定稼働が維持できる。 |
最終アドバイス:まずは Free プランでエンドツーエンドのフロー(データ収集 → 可視化)を一通り体験し、上記チェックリストと比較しながら課題を洗い出すことが成功への近道です。課題が顕在化した段階で Standard 以上へスムーズに移行できれば、コストと運用のバランスを最適化しつつ、Grafana Cloud のフルパワーを活かすことが可能です。
本稿は公式ドキュメント(2024 年 11 月版)を元に作成しています。プランや機能は予告なく変更される場合がありますので、最新情報は必ず公式サイトでご確認ください。