Firebase bietet Benachrichtigungen für eine Vielzahl von Ereignissen zur Projekt- und App-Verwaltung. Hier sind einige Beispiele für Ereignisse, bei denen Firebase Ihnen diese Art von Benachrichtigung senden kann:
- Ab dem Crashlytics können wir Sie benachrichtigen, wenn die Anzahl der Abstürze Ihrer App stark zunimmt.
- Bei Performance Monitoring können wir Sie benachrichtigen, wenn die Startzeit Ihrer App den konfigurierten Grenzwert überschreitet.
- Bei App Distribution können wir Sie benachrichtigen, wenn einer Ihrer Tester ein neues iOS-Gerät registriert.
Je nach Benachrichtigung und den vom Projektmitglied festgelegten Einstellungen werden diese Benachrichtigungstypen in der Firebase Console angezeigt oder per E-Mail gesendet.
Auf dieser Seite wird beschrieben, wie Sie Funktionen in Cloud Functions for Firebase (2. Generation) schreiben, die Benachrichtigungsereignisse verarbeiten.
Funktionsweise
Sie können Funktionen als Reaktion auf Benachrichtigungsereignisse auslösen, die von diesen Quellen gesendet werden:
- App Distribution-Benachrichtigungsereignisse verarbeiten
- Crashlytics-Benachrichtigungsereignisse verarbeiten
- Performance Monitoring-Benachrichtigungsereignisse verarbeiten
Im typischen Lebenszyklus führt eine Funktion, die durch ein Benachrichtigungsereignis ausgelöst wird, folgende Vorgänge aus:
- Hört/wartet darauf, dass ein bestimmter Benachrichtigungstyp von Firebase gesendet wird.
- Wird ausgelöst, wenn die Benachrichtigung gesendet wird, und empfängt die Ereignisnutzlast mit bestimmten Informationen zum Ereignis.
- Der Code Ihrer Funktion wird aufgerufen, um die Ereignisnutzlast zu verarbeiten.
Funktion bei Benachrichtigungsereignissen auslösen
Verwenden Sie das Unterpaket firebase-functions/v2/alerts
, um eine Funktion zu schreiben, die Benachrichtigungsereignisse verarbeitet. Die folgenden produktspezifischen Beispiele veranschaulichen einen Workflow, bei dem eine Funktion über einen Webhook eine Nachricht in einem Discord-Kanal postet, wenn eine Benachrichtigung für dieses Produkt von Firebase gesendet wird.
Crashlytics-Benachrichtigungsereignisse verarbeiten
Im folgenden Crashlytics-Beispiel wird Cloud Functions for Firebase verwendet, um ein Benachrichtigungsereignis zu einem neuen schwerwiegenden Absturz zu verarbeiten. Diese Funktion sendet die Benachrichtigungsinformationen in einer Nachricht an einen Discord-Kanal.
Die Funktion wartet auf das Ereignis, das der Veröffentlichung eines neuen schwerwiegenden Problems durch Firebase entspricht:
Node.js
exports.postfatalissuetodiscord = onNewFatalIssuePublished(async (event) => {
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."""
Die Funktion analysiert dann das zurückgegebene Ereignisobjekt, liest nützliche Informationen aus der Ereignisnutzlast und erstellt eine Nachricht, die im Discord-Kanal gepostet wird:
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}\`
`;
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()
Schließlich sendet die Funktion die erstellte Nachricht über eine HTTP-Anfrage an 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);
}
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()
Informationen zu allen Crashlytics-Benachrichtigungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für Crashlytics-Benachrichtigungen.
Performance Monitoring-Benachrichtigungsereignisse verarbeiten
In diesem Beispiel wird eine Funktion exportiert, die auf Ereignisse für Benachrichtigungen zu Leistungsgrenzwerten achtet:
Node.js
exports.postperformancealerttodiscord = onThresholdAlertPublished(
async (event) => {
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."""
Die Funktion analysiert dann das zurückgegebene Ereignisobjekt, liest nützliche Informationen aus der Ereignisnutzlast und erstellt eine Nachricht, die im Discord-Kanal gepostet wird:
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}
`;
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()
Schließlich sendet die Funktion die erstellte Nachricht über eine HTTP-Anfrage an 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);
}
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()
Informationen zu allen Ereignissen für Leistungsbenachrichtigungen, die Sie erfassen können, finden Sie in der Referenzdokumentation für Performance Monitoring-Benachrichtigungen.
App Distribution-Benachrichtigungsereignisse verarbeiten
Im Beispiel in diesem Abschnitt wird gezeigt, wie Sie eine Funktion für Benachrichtigungen zu neuen Tester-iOS-Geräten schreiben.
In diesem Beispiel überwacht die Funktion Ereignisse, die jedes Mal gesendet werden, wenn ein Tester ein neues iOS-Gerät registriert. Wenn ein neues iOS-Gerät registriert wird, müssen Sie Ihr Bereitstellungsprofil mit der UDID dieses Geräts aktualisieren und die App dann neu verteilen.
Node.js
exports.postnewduuidtodiscord = onNewTesterIosDevicePublished(async (event) => {
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."""
Die Funktion analysiert dann das zurückgegebene Objekt, liest nützliche Informationen aus der Ereignisnutzlast und erstellt eine Nachricht, die auf dem Discord-Kanal gepostet wird:
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}
`;
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()
Schließlich sendet die Funktion die erstellte Nachricht über eine HTTP-Anfrage an 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);
}
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()
Informationen zu allen App Distribution-Benachrichtigungsereignissen, die Sie erfassen können, finden Sie in der Referenzdokumentation für App Distribution-Benachrichtigungen.
Informationen zur Verwendung einer Funktion, die durch eine Firebase-Benachrichtigung zu In-App-Feedback von App Distribution ausgelöst wird, finden Sie unter In-App-Feedback an Jira senden.