メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.jitera.ai/llms.txt

Use this file to discover all available pages before exploring further.

Jitera Self-Hostedは、すべてのアプリケーションサービスにわたるリアルタイムのエラー追跡、アラート、診断のためにRollbarと連携します。Rollbarは、サーバーサイドとクライアントサイドの両方のコードからの未処理の例外、エラー、ログメッセージをキャプチャします。
Rollbarはオプションです。トークンが設定されていない場合、エラー監視は単に無効になります — Jiteraの動作には影響しません。

​
仕組み

Jiteraはデプロイ時にRollbarトークンと環境識別子を各サービスに注入します。エラーが発生すると、サービスはサービス名、環境、スタックトレース、リクエストメタデータを含むコンテキストとともにRollbarに報告します。
サービストークンソース
Automation（Rails）credentials.rollbar.post_server_item_access_token
Frontendcredentials.rollbar.post_client_item_access_token
Frontend Corecredentials.rollbar.post_client_item_access_token
Ultroncredentials.rollbar.post_server_item_access_token
Boostcredentials.boost.JITERA_BOOST_ROLLBAR_ACCESS_TOKEN
サーバートークン（post_server_item_access_token）はバックエンドサービス（Automation、Ultron）で使用されます。サーバーサイドコードからエラーを報告する書き込みアクセス権を持ちます。 クライアントトークン（post_client_item_access_token）はフロントエンドサービス（Frontend、Frontend Core）で使用されます。ブラウザで実行されるクライアントサイドJavaScriptに適した制限付き権限を持ちます。 Boostトークン（JITERA_BOOST_ROLLBAR_ACCESS_TOKEN）はBoostサービス用の個別トークンで、共有のRollbar認証情報とは独立して設定されます。

​
前提条件

  1. Rollbarアカウントを作成し、Jiteraデプロイメント用のプロジェクトを作成
  2. Rollbarプロジェクト設定から以下の3つのアクセストークンを生成してください。それぞれ異なる権限レベルを持つ個別のトークンが必要です：
    • post_server_itemトークン — バックエンドサービス（Automation、Ultron）で使用
    • post_client_itemトークン — フロントエンドサービス（Frontend、Frontend Core）で使用。ブラウザサイドのコードに適した制限付き権限
    • Boost用の個別トークン — Boostサービスは独自のトークンを使用し、独立して設定
トークンの作成手順については、Rollbarアクセストークンのドキュメントを参照してください。

​
設定

​
Rollbarトークン

credentials:
  rollbar:
    post_server_item_access_token: "<ROLLBAR_SERVER_TOKEN>"   # バックエンドサービス（Automation、Ultron）
    post_client_item_access_token: "<ROLLBAR_CLIENT_TOKEN>"   # フロントエンドサービス

  boost:
    JITERA_BOOST_ROLLBAR_ACCESS_TOKEN: "<ROLLBAR_BOOST_TOKEN>"  # Boostサービス

​
環境名

各サービスはRollbarに環境名を報告します。これにより、デプロイステージ（例：production、staging）でエラーをフィルタリングできます。デフォルトはproductionに設定されています： 
frontend:
  env:
    ROLLBAR_ENV: production

frontend_core:
  env:
    VITE_ROLLBAR_ENVIRONMENT: production

ultron:
  env:
    ROLLBAR_ENVIRONMENT: production

boost:
  env:
    JITERA_BOOST_ROLLBAR_ENVIRONMENT: production
AutomationサービスはFrontendと同じ認証情報設定からROLLBAR_ENVを読み取ります。Automationに異なる環境名が必要な場合は、automation.env.ROLLBAR_ENVで上書きできます。
Rollbar関連のHelmパラメータの完全なリストについては、Helm Valuesリファレンスのcredentials.rollbarセクションを参照してください。

​
検証

Rollbarトークンを設定してデプロイした後： 
# Automationにトークンが注入されているか確認
kubectl exec -it deploy/jitera-automation-rails -n jitera -- \
  cat /app/config/secrets.yml | grep rollbar

# Boostトークンの確認
kubectl exec -it deploy/jitera-boost -n jitera -- \
  env | grep ROLLBAR

# Ultron環境の確認
kubectl exec -it deploy/jitera-ultron -n jitera -- \
  env | grep ROLLBAR
その後、アプリケーションでテストエラーをトリガーし、Rollbarダッシュボードに表示されることを確認してください。

​
ネットワーク要件

Rollbarにはクラスターからapi.rollbar.com:443へのアウトバウンドHTTPSアクセスが必要です。必要なアウトバウンドルールの完全なリストについては、ネットワークとファイアウォールの「3rd Party Integrations」テーブルを参照してください。