DOCS
インテグレーションガイド / Scalyr

Scalyr

本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。

Scalyrは、複数の機能を1つのツールに統合します:ログの集約、検索、分析; サーバーメトリック; ダッシュボードとアラート、外部モニタリングなどがあります。 PagerDutyのオンコールスケジューリングとアラート機能を組み合わせることで、システムが監視されていることを確認したり、問題が発生したときにオンコールチームに通知したりすることがより簡単にできます。

Scalyrアラートがトリガされると、ScalyrはPagerDutyにインシデントを報告します。 アラートが解決された場合、ScalyrはPagerDutyインシデントを解決済みとしてマークします。 Scalyrアラートの一部またはすべてにPagerDutyを使用できます。 ScalyrがPagerDutyと電子メールアドレスの両方のリストに通知を送信するように選択することもできます。

PagerDutyでの設定

  1. ConfigurationメニューからServicesを選択します。

  2. Serviceページで:インテグレーションのために新しいサービスを作成する場合は、+Add New Serviceをクリックします。 既存のサービスにインテグレーションを追加する場合は、追加するサービスの名前をクリックします。 その後、Integrations タブをクリックし、+ New Integrationボタンをクリックします。 RS-Add-New-Service

  3. Integration Typeメニューから追加したいアプリを選択して、Integration Nameを入力してください。 インテグレーションのために新しいサービスを作成する場合は、General Settingで新し いサービスのNameを入力します。 次に、インシデント設定で、新しいサービスのEscalation Policy, Notification Urgency 、およびIncident Behaviorを指定します。

  4. Add ServiceまたはAdd Integrationボタンをクリックして、新しいインテグレーションを保存します。 すると、サービスのIntegrationsページに回送されます。 RS-Integration-Settings

  5. 新しいインテグレーションのIntegration Keyをコピーします。 RS_Updates__API_Services-1024x146-8

Scalyrでの設定

  1. Alertsナビゲーションリンクをクリックし、 Edit Alertsをクリックします。 edit_alerts-300x57

  2. アラート設定ファイルを編集して、アラート受信者としてPagerDutyを指定します。 すべてのScalyrアラートでこれを行うには、ファイルの最上位レベルにalertAddressフィールドを作成または編集します。

    {
        "alertAddress": "pagerduty:XXXXX",
    
        alerts: [
         ...
         ]
     }
    

    XXXXXをPagerDutyで生成したIntegration Key(上記のステップ6を参照)に置き換えます。PagerDutyに加えて、1つ以上の電子メールアドレスに通知を送信するには、alertAddressにすべてをリストします。

     "alertAddress": "pagerduty:XXXXX, foo@example.com, bar@example.com",
    
    

    特定のアラートにのみPagerDutyを使用する場合は、アラートのalertAddressフィールドで指定できます。

    {
    alertAddress: "email@example.com",
    
    alerts: [
      // This alert will be sent to PagerDuty
      {
        trigger: "count:1m(error) > 10",
        "alertAddress": "pagerduty:XXXXX",
    },
    
    // This alert will send notifications to email@example.com
    {
      trigger: "mean:10m($source='tsdb' $serverHost='server1' metric='proc.stat.cpu_rate' type='user') > 50"
      }
     ]
    }
    

    アラート全体をPagerDutyにリンクするには、そのグループに適切なalertAddressを指定します。Specifying Alert Recipients(アラート受信者の指定) を参照してください。

ScalyrとPagerDutyが通信していることを確認するには

テストアラートをトリガーすると、通信していることを確認できます。 アラートがクリアされると、インシデントはPagerDuty内で自動的に解決されます。ただしScalyrがPagerDutyにRESOLVE通知を送信するまでには約5分かかります。

よくある質問

  1. Scalyrを複数のPagerDutyサービスに総合するにはどう設定すればよいでしょうか?

    PagerDutyでは、任意の数のScalyr/Generic APIサービスを作成でき、それぞれ独自のエスカレーションポリシーを設定できます。Scalyrを複数のサービスにリンクするには、各alertAddressフィールドに適切なインテグレーションキーを入力するだけです。

    インストールが失敗した場合は、 サポート support@pagerduty.comまで連絡してください。