Firebase सूचना के ट्रिगर

Firebase कई तरह के प्रोजेक्ट और ऐप्लिकेशन मैनेजमेंट के लिए सूचना देता है इवेंट. Firebase आपको यह मैसेज कब भेज सकता है, इसके लिए यहां कुछ इवेंट के उदाहरण दिए गए हैं अलर्ट का टाइप:

• Crashlytics के लिए, हम आपको चेतावनी दे सकते हैं. ऐसा तब होता है, जब आपके ऐप्लिकेशन में बंद हो जाता है.
• परफ़ॉर्मेंस मॉनिटर करने के लिए, हम आपको तब सूचना दे सकते हैं, जब आपके ऐप्लिकेशन के शुरू होने का समय कॉन्फ़िगर किया गया थ्रेशोल्ड.
• App Distribution के लिए, अगर आपका कोई टेस्टर नया iOS रजिस्टर करता है, तो हम आपको इसकी सूचना दे सकते हैं डिवाइस.

सूचना और प्रोजेक्ट की सेट की गई सेटिंग के आधार पर सदस्य, Firebase इस तरह की सूचनाएं Firebase कंसोल में दिखाता है या उन्हें भेजता है देखें.

इस पेज पर, Firebase के लिए Cloud Functions (2nd gen) में फ़ंक्शन लिखने का तरीका बताया गया है जो अलर्ट इवेंट हैंडल करते हैं.

यह कैसे काम करता है?

इन सोर्स से जनरेट होने वाली सूचना इवेंट के जवाब में, फ़ंक्शन ट्रिगर किए जा सकते हैं:

• App Distribution से जुड़ी चेतावनी वाले इवेंट मैनेज करना
• Crshlytics से जुड़ी चेतावनी वाले इवेंट को मैनेज करें
• परफ़ॉर्मेंस के बारे में बताने वाले अलर्ट से जुड़े इवेंट को मैनेज करना

किसी सामान्य लाइफ़साइकल में, किसी सूचना इवेंट से ट्रिगर होने वाला फ़ंक्शन, फ़ॉलो किया जा रहा है:

1. Firebase से मिलने वाली किसी खास तरह की चेतावनी को सुनता है/इंतज़ार करता है.
2. यह तब ट्रिगर होता है, जब सूचना भेजी जाती है. साथ ही, उस इवेंट पेलोड को ट्रिगर किया जाता है जो इवेंट के बारे में खास जानकारी मौजूद हो.
3. इवेंट पेलोड को हैंडल करने के लिए, आपके फ़ंक्शन के कोड को शुरू करता है.

सूचना से जुड़े इवेंट पर फ़ंक्शन ट्रिगर करें

ऐसा फ़ंक्शन लिखने के लिए firebase-functions/v2/alerts सबपैकेज का इस्तेमाल करें चेतावनी वाले इवेंट मैनेज करता है. अलग-अलग प्रॉडक्ट के ये उदाहरण दिखाते हैं कि वर्कफ़्लो में एक फ़ंक्शन, Discord चैनल पर मैसेज पोस्ट करने के लिए वेबहुक का इस्तेमाल करता है जब Firebase से उस प्रॉडक्ट के लिए कोई सूचना मिलती है.

Crashlytics की चेतावनी वाले इवेंट को मैनेज करना

Crashlytics के नीचे दिए गए उदाहरण में, 'Firebase के लिए Cloud Functions' का इस्तेमाल किया जा सकता है किसी नई गंभीर क्रैश समस्या की चेतावनी इवेंट को हैंडल करने के लिए किया जा सकता है. यह फ़ंक्शन सूचना को पोस्ट करता है Discord चैनल को भेजे गए मैसेज में मौजूद जानकारी.

फ़ंक्शन, Firebase से जुड़े इवेंट को सुनता है कोई नई गंभीर समस्या पब्लिश करना:

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

@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 चैनल पर पोस्ट करने के लिए:

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

    # 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

आखिर में, फ़ंक्शन बनाया गया मैसेज 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

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 से जुड़ी चेतावनियां.

परफ़ॉर्मेंस के बारे में बताने वाले अलर्ट से जुड़े इवेंट को मैनेज करना

इस उदाहरण में, एक ऐसे फ़ंक्शन को एक्सपोर्ट किया गया है जो परफ़ॉर्मेंस थ्रेशोल्ड के अलर्ट इवेंट के बारे में पता करता है:

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

@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

इसके बाद, यह फ़ंक्शन, दिखाए गए इवेंट ऑब्जेक्ट को पार्स करता है. साथ ही, काम की जानकारी पार्स करता है इवेंट पेलोड से क्लिक करके और 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

    # 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

आखिर में, यह फ़ंक्शन एक एचटीटीपी के ज़रिए, बनाए गए मैसेज को 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

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

कैप्चर किए जा सकने वाले सभी परफ़ॉर्मेंस अलर्ट इवेंट के बारे में जानने के लिए, यहां जाएं के लिए संदर्भ दस्तावेज़ परफ़ॉर्मेंस मॉनिटर करने से जुड़ी चेतावनियां.

App Distribution से जुड़ी चेतावनी वाले इवेंट को मैनेज करना

इस सेक्शन में दिए गए उदाहरण में, iOS के नए टेस्टर के लिए फ़ंक्शन लिखने का तरीका बताया गया है डिवाइस की सूचनाएँ.

इस उदाहरण में, फ़ंक्शन उन इवेंट को सुनता है जिन्हें हर बार टेस्टर ने नए iOS डिवाइस को रजिस्टर किया है. नए iOS डिवाइस को रजिस्टर करने पर, आपको इन चीज़ों की ज़रूरत होगी उपयोगकर्ता प्रोफ़ाइल को उस डिवाइस के UDID से अपडेट करें और फिर फिर से लोगों तक पहुंचाना.

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

@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 चैनल पर पोस्ट करने के लिए मैसेज बनाना:

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

    # 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

आखिर में, यह फ़ंक्शन एक एचटीटीपी के ज़रिए, बनाए गए मैसेज को 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

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 से ऐप्लिकेशन में मिलने वाले सुझाव के लिए Firebase की चेतावनी, Jira को ऐप्लिकेशन में सुझाव/राय देना या शिकायत करना देखें.