Firebase アラートのトリガー

Firebase には、さまざまなプロジェクトやアプリ管理イベントに対応するアラートが用意されています。Firebase でこのようなアラートを送信できるイベントの例を次に示します。

Crashlytics では、アプリのクラッシュが急増した場合にアラートが通知されます。
Performance Monitoring では、アプリの起動時間が構成済みのしきい値を超えるとアラートが通知されます。
App Distribution では、テスターが新しい iOS デバイスを登録した場合にアラートが通知されます。

Firebase では、アラートの種類やプロジェクトメンバーによる設定に応じて、アラートは Firebase コンソールに表示されるか、メールで送信されます。

このページでは、アラートイベントを処理する関数の作成方法について説明します。

仕組み

次のソースで生じたアラートイベントに対応して、関数をトリガーできます。

App Distribution アラートイベントを処理する
Crashlytics アラートイベントを処理する
Performance Monitoring アラートイベントを処理する

一般的なライフサイクルの場合、アラートイベントによってトリガーされる関数は以下のように機能します。

Firebase から、特定の種類のアラートが生じるまでリッスン / 待機します。
アラートが発生するとトリガーされて、イベントに関する特定の情報を含むイベントペイロードを受信します。
関数のコードを呼び出して、イベントペイロードを処理します。

アラートイベント発生時に関数をトリガーする

firebase-functions/v2/alerts サブパッケージを使用して、アラートイベントを処理する関数を作成します。以下のプロダクト固有の例は、当該プロダクトに関するアラートが Firebase から出された場合に、関数で Webhook を使用して Discord チャネルにメッセージを投稿するワークフローを示しています。

Crashlytics アラートイベントを処理する

次の Crashlytics の例では、Cloud Functions for Firebase を使用して、致命的な新しいクラッシュの問題のアラートイベントを処理します。この関数は、アラート情報をメッセージにして Discord チャネルに投稿します。

Discord でのクラッシュ通知の例

致命的な新しいクラッシュの問題の通知の例

この関数は onNewFatalIssuePublished イベントをリッスンします。

exports.postfatalissuetodiscord = onNewFatalIssuePublished(async (event) => {index.js

続いてこの関数は、返されたイベントオブジェクトを解析し、Discord チャネルに投稿するメッセージを作成します。

  // construct a helpful message to send to Discord
  const appId = event.appId;
  const {id, title, subtitle, appVersion} = event.data.payload.issue;
  const message = `
🚨 New fatal issue for ${appId} in version ${appVersion} 🚨

**${title}**

${subtitle}

id: \`${id}\`
`;index.js

最後に、作成したメッセージを Discord に送信します。

    const response = await postMessageToDiscord("Crashlytics Bot", message);
    if (response.ok) {
      logger.info(
          `Posted fatal Crashlytics alert ${id} for ${appId} to Discord`,
          event.data.payload,
      );
    } else {
      throw new Error(response.error);
    }index.js

キャプチャできる Crashlytics アラートイベントの詳細については、Crashlytics アラートのリファレンスドキュメントをご覧ください。

Performance Monitoring アラートイベントを処理する

このセクションの例では、パフォーマンスしきい値アラートの関数を作成する方法を紹介しています。

この例では、パフォーマンスしきい値アラートが出されるたびに送信される、PerformanceEvent<ThresholdAlertPayload> タイプのイベントをリッスンする Cloud Functions 関数を onThresholdAlertPublished 関数でエクスポートします。

exports.postperformancealerttodiscord = onThresholdAlertPublished(
    async (event) => {index.js

続いてこの関数は、返されたイベントオブジェクトを解析し、イベントペイロードに含まれる有用な情報を解析して、Discord チャネルに投稿するメッセージを作成します。

      // construct a helpful message to send to Discord
      const appId = event.appId;
      const {
        eventName,
        metricType,
        eventType,
        numSamples,
        thresholdValue,
        thresholdUnit,
        conditionPercentile,
        appVersion,
        violationValue,
        violationUnit,
        investigateUri,
      } = event.data.payload;
      const message = `
    ⚠️ Performance Alert for ${metricType} of ${eventType}: **${eventName}** ⚠️

    App id: ${appId}
    Alert condition: ${thresholdValue} ${thresholdUnit}
    Percentile (if applicable): ${conditionPercentile}
    App version (if applicable): ${appVersion}

    Violation: ${violationValue} ${violationUnit}
    Number of samples checked: ${numSamples}

    **Investigate more:** ${investigateUri}
    `;index.js

最後に、作成したメッセージを HTTP リクエストを介して Discord に送信します。

        const response = await postMessageToDiscord(
            "Firebase Performance Bot", message);
        if (response.ok) {
          logger.info(
              `Posted Firebase Performance alert ${eventName} to Discord`,
              event.data.payload,
          );
        } else {
          throw new Error(response.error);
        }index.js

キャプチャできるすべてのパフォーマンスアラートイベントについては、Performance Monitoring アラートのリファレンスドキュメントをご覧ください。

App Distribution アラートイベントを処理する

このセクションの例では、テスターの新しい iOS デバイスのアラートの関数を作成する方法を紹介しています。

この例では、テスターが新しい iOS デバイスを登録するたびに送信される、AppDistributionEvent<NewTesterDevicePayload> タイプのイベントをリッスンする Cloud Functions の関数を onNewTesterIosDevicePublished 関数でエクスポートします。新しい iOS デバイスが登録されたら、そのデバイスの UDID でプロビジョニングプロファイルを更新して、アプリを再配布する必要があります。

exports.postnewduuidtodiscord = onNewTesterIosDevicePublished(async (event) => {index.js

  // construct a helpful message to send to Discord
  const appId = event.appId;
  const {
    testerDeviceIdentifier,
    testerDeviceModelName,
    testerEmail,
    testerName,
  } = event.data.payload;
  const message = `
📱 New iOS device registered by ${testerName} <${testerEmail}> for ${appId}

UDID **${testerDeviceIdentifier}** for ${testerDeviceModelName}
`;index.js

最後に、作成したメッセージを HTTP リクエストを介して Discord に送信します。

    const response = await postMessageToDiscord("AppDistribution Bot", message);
    if (response.ok) {
      logger.info(
          `Posted iOS device registration alert for ${testerEmail} to Discord`,
      );
    } else {
      throw new Error(response.error);
    }index.js

キャプチャできる App Distribution アラートイベントについては、App Distribution アラートのリファレンスドキュメントをご覧ください。

App Distribution のアプリ内フィードバック Firebase アラートによってトリガーされる関数の使用方法については、アプリ内フィードバックを Jira に送信するをご覧ください。

Firebase アラートのトリガー

仕組み

アラート イベント発生時に関数をトリガーする

Crashlytics アラート イベントを処理する

Performance Monitoring アラート イベントを処理する

App Distribution アラート イベントを処理する

アラートイベント発生時に関数をトリガーする

Crashlytics アラートイベントを処理する

Performance Monitoring アラートイベントを処理する

App Distribution アラートイベントを処理する