Firebase アラートのトリガー

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

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

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

このページでは、アラートイベントを処理する Cloud Functions for Firebase（第 2 世代）の関数を作成する方法について説明します。

仕組み

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

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

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

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

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

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

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

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

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

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

この関数は、Firebase の新しい致命的な問題のパブリッシュに対応するイベントをリッスンします。

Node.js

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

Python（プレビュー）

@crashlytics_fn.on_new_fatal_issue_published(secrets=["DISCORD_WEBHOOK_URL"])
def post_fatal_issue_to_discord(
    event: crashlytics_fn.CrashlyticsNewFatalIssueEvent,
) -> None:
    """Publishes a message to Discord whenever a new Crashlytics fatal issue occurs."""main.py

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

Node.js

  // 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

Python（プレビュー）

    # Construct a helpful message to send to Discord.
    app_id = event.app_id
    issue = event.data.payload.issue
    message = f"""
🚨 New fatal issue for {app_id} in version {issue.app_version} 🚨

# {issue.title}

{issue.subtitle}

ID: `{issue.id}`
""".strip()main.py

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

Node.js

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

Python（プレビュー）

response = post_message_to_discord(
    "Crashlytics Bot", message, DISCORD_WEBHOOK_URL.value
)
if response.ok:
    print(
        f"Posted fatal Crashlytics alert {issue.id} for {app_id} to Discord."
    )
    pprint.pp(event.data.payload)
else:
    response.raise_for_status()main.py

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

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

この例では、パフォーマンスしきい値アラートイベントをリッスンする関数をエクスポートします。

Node.js

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

Python（プレビュー）

@performance_fn.on_threshold_alert_published(secrets=["DISCORD_WEBHOOK_URL"])
def post_performance_alert_to_discord(
    event: performance_fn.PerformanceThresholdAlertEvent,
) -> None:
    """Publishes a message to Discord whenever a performance threshold alert is fired."""main.py

Node.js

      // 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

Python（プレビュー）

    # Construct a helpful message to send to Discord.
    app_id = event.app_id
    perf = event.data.payload
    message = f"""
⚠️ Performance Alert for {perf.metric_type} of {perf.event_type}: **{perf.event_name}** ⚠️

App ID: {app_id}
Alert condition: {perf.threshold_value} {perf.threshold_unit}
Percentile (if applicable): {perf.condition_percentile}
App version (if applicable): {perf.app_version}

Violation: {perf.violation_value} {perf.violation_unit}
Number of samples checked: {perf.num_samples}

**Investigate more:** {perf.investigate_uri}
""".strip()main.py

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

Node.js

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

Python（プレビュー）

response = post_message_to_discord(
    "App Performance Bot", message, DISCORD_WEBHOOK_URL.value
)
if response.ok:
    print(
        f"Posted Firebase Performance alert {perf.event_name} to Discord."
    )
    pprint.pp(event.data.payload)
else:
    response.raise_for_status()main.py

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

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

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

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

Node.js

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

Python（プレビュー）

@app_distribution_fn.on_new_tester_ios_device_published(
    secrets=["DISCORD_WEBHOOK_URL"]
)
def post_new_udid_to_discord(
    event: app_distribution_fn.NewTesterDeviceEvent,
) -> None:
    """Publishes a message to Discord whenever someone registers a new iOS test device."""main.py

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

Node.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

Python（プレビュー）

    # Construct a helpful message to send to Discord.
    app_id = event.app_id
    app_dist = event.data.payload
    message = f"""
📱 New iOS device registered by {app_dist.tester_name} <{app_dist.tester_email}> for {app_id}

UDID **{app_dist.tester_device_identifier}** for {app_dist.tester_device_model_name}
""".strip()main.py

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

Node.js

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

Python（プレビュー）

response = post_message_to_discord(
    "App Distro Bot", message, DISCORD_WEBHOOK_URL.value
)
if response.ok:
    print(
        f"Posted iOS device registration alert for {app_dist.tester_email} to Discord."
    )
    pprint.pp(event.data.payload)
else:
    response.raise_for_status()main.py

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

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

Firebase アラートのトリガー

仕組み

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

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

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

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

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

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

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

Node.js

Python（プレビュー）

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

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

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

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