RobustaDev

RobustaDev

Robusta の包括的なガイドです。Playbook、AI による調査、自動修復を活用して、Kubernetes のアラートを実行可能なインサイトに変換する SRE エージェントです。

クイックリファレンス

コンポーネント	目的
Playbook	アラートへの対応を定義するルールエンジン
トリガー	Playbook の実行を開始するイベント
アクション	修復手順と情報の追加
シンク	通知の送信先（Slack、Teams、PagerDuty など）

ワークフローのルーティング

ワークフロー	トリガー	ファイル
Install	"install robusta", "deploy robusta"	Workflows/Install.md
ConfigurePlaybooks	"create playbook", "configure playbook"	Workflows/ConfigurePlaybooks.md
ConfigureSinks	"setup slack", "configure notifications"	Workflows/ConfigureSinks.md
Troubleshoot	"robusta not working", "alerts not firing"	Workflows/Troubleshoot.md

インストールのクイックスタート

前提条件

• Kubernetes クラスター
• Helm 3.x のインストール
• kubectl の設定

オールインワンのインストール（Robusta + Prometheus）

# Generate configuration
pipx run robusta-cli gen-config --enable-prometheus-stack

# Or using Docker
curl -fsSL -o robusta https://docs.robusta.dev/master/_static/robusta
chmod +x robusta
./robusta gen-config --enable-prometheus-stack

# Install via Helm
helm repo add robusta https://robusta-charts.storage.googleapis.com
helm repo update
helm install robusta robusta/robusta \
  -f ./generated_values.yaml \
  --set clusterName=<YOUR_CLUSTER_NAME>

# Verify installation
kubectl get pods -A | grep robusta

スタンドアロンのインストール（既存の Prometheus を使用）

pipx run robusta-cli gen-config
helm install robusta robusta/robusta -f ./generated_values.yaml

Playbook の構成

# Example playbook in generated_values.yaml
customPlaybooks:
  - triggers:
      - on_prometheus_alert:
          alert_name: KubePodCrashLooping
    actions:
      - logs_enricher: {}
      - pod_events_enricher: {}
    sinks:
      - slack

トリガーの種類

トリガー	説明
on_prometheus_alert	Prometheus／AlertManager のアラート発生時に実行
on_pod_create	Pod の作成時
on_pod_update	Pod の更新時
on_deployment_update	Deployment の変更時
on_schedule	Cron ベースのスケジュール実行
on_kubernetes_warning_event	K8s の警告イベント発生時

一般的なアクション

アクション	目的
logs_enricher	アラートに Pod のログを追加
pod_events_enricher	K8s イベントを追加
node_cpu_enricher	CPU メトリクスを追加
node_memory_enricher	メモリーメトリクスを追加
deployment_status_enricher	Deployment 情報を追加
delete_pod	Pod を削除して自動修復
node_bash_enricher	ノード上で bash コマンドを実行

シンクの設定

Slack

sinksConfig:
  - slack_sink:
      name: main_slack
      slack_channel: alerts
      api_key: xoxb-your-token

Microsoft Teams

sinksConfig:
  - ms_teams_sink:
      name: teams_alerts
      webhook_url: https://outlook.office.com/webhook/...

PagerDuty

sinksConfig:
  - pagerduty_sink:
      name: pagerduty
      api_key: your-integration-key

Webhook（汎用）

sinksConfig:
  - webhook_sink:
      name: custom_webhook
      url: https://your-endpoint.com/alerts

例

例 1：Prometheus と一緒に Robusta をインストール

User: "Install Robusta on my AKS cluster"
-> Generate config with gen-config --enable-prometheus-stack
-> Add Helm repo and install with cluster name
-> Verify pods are running

例 2：クラッシュループの情報を追加する Playbook を作成

User: "Add pod logs to CrashLoopBackOff alerts"
-> Create playbook with on_prometheus_alert trigger
-> Add logs_enricher and pod_events_enricher actions
-> Configure Slack sink for notifications

例 3：Slack 通知を設定

User: "Send Robusta alerts to #k8s-alerts Slack channel"
-> Add slack_sink to sinksConfig
-> Set channel name and API key
-> Optionally filter by severity or namespace

例 4：アラートが見つからない場合のデバッグ

User: "Robusta isn't sending alerts to Slack"
-> Check robusta-runner pod logs
-> Verify sink configuration in generated_values.yaml
-> Test with manual trigger: robusta playbooks trigger

主な概念

アラートの流れ

Prometheus Alert -> AlertManager -> Robusta -> Playbook -> Actions -> Sinks

Playbook の構成要素

1. トリガー - Playbook を開始するイベント
2. アクション - トリガーされたときの処理（情報の追加、修復）
3. シンク - 結果の送信先

スマートグルーピング

Robusta は Slack のスレッドを使用して関連するアラートをグループ化し、通知の過剰送信を抑制します。

AI による調査（HolmesGPT）

オプションの AI による根本原因分析は、Robusta Pro またはセルフホスト可能な HolmesGPT で利用できます。

リファレンスドキュメント

• references/Installation.md - 詳細なインストールガイド
• references/Playbooks.md - Playbook の完全なリファレンス
• references/Triggers.md - すべてのトリガーの種類
• references/Actions.md - 利用可能なアクション
• references/Sinks.md - シンクの設定
• references/Troubleshooting.md - よくある問題と解決方法

外部リソース

• 公式ドキュメント
• GitHub
• Robusta Platform（SaaS UI）