Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

लॉग लिखें और देखें

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

लॉगिंग डिबगिंग और कोड की निगरानी के लिए एक महत्वपूर्ण उपकरण है। क्लाउड फ़ंक्शंस आपको इसके लॉगर एसडीके, कस्टम Google क्लाउड लॉगिंग, या वेब के लिए विकसित करने के लिए console ऑब्जेक्ट मानक का उपयोग करने का विकल्प देता है।

लॉग लिखना

जबकि अधिकांश स्थितियों के लिए Cloud Functions लकड़हारा SDK की अनुशंसा की जाती है, आप इन कारणों से अन्य विकल्पों में से एक चुन सकते हैं:

  • आपके पास मौजूदा कोड आधार है और console.log से रिफैक्टर नहीं करना पसंद करते हैं।
  • आप क्लाउड लॉगिंग (पूर्व में स्टैकड्राइवर लॉगिंग) से परिचित हैं और कस्टम लॉगिंग के लिए इसका उपयोग करना पसंद करते हैं।

क्लाउड फ़ंक्शंस लॉगर एसडीके का उपयोग करना

क्लाउड फ़ंक्शंस लॉगर एसडीके एक मानक इंटरफ़ेस प्रदान करता है जिसमें console.log स्टेटमेंट के समान एपीआई है और अन्य लॉग स्तरों का समर्थन करता है। आप इस SDK का उपयोग संरचित डेटा के साथ ईवेंट लॉग करने के लिए कर सकते हैं, जिससे विश्लेषण और निगरानी आसान हो जाती है।

लॉगर एसडीके वाइल्डकार्ड आयात के हिस्से के रूप में लॉग प्रविष्टियों का समर्थन करता है। उदाहरण के लिए:

  const functions = require("firebase-functions");

  functions.logger.log("Hello from info. Here's an object:", someObj);

वैकल्पिक रूप से, आप व्यक्तिगत निर्यात का उपयोग कर सकते हैं। यह उदाहरण अंतिम तर्क के रूप में लॉग से जुड़े संरचित डेटा को प्रदर्शित करता है:

const { warn } = require("firebase-functions/logger");


// Attach structured data to the log as the last argument.
warn("This is a 'WARNING' severity message with some metadata.", {
  key1: 'val1',
  key2: 'val2'
});
  • logger.log() कमांड में INFO लॉग स्तर होता है।
  • logger.info() कमांड में INFO लॉग स्तर होता है।
  • logger.warn() कमांड में ERROR लॉग लेवल होता है।
  • logger.error() कमांड में ERROR लॉग लेवल होता है।
  • आंतरिक सिस्टम संदेशों में DEBUG लॉग स्तर होता है।

logger.write() के साथ, आप CRITICAL , ALERT , और EMERGENCY के लॉग प्रविष्टियाँ जोड़ लॉग गंभीरता स्तर लिख सकते हैं। लॉगसेवरिटी देखें।

कस्टम क्लाउड लॉगिंग लॉग

लकड़हारा एसडीके के साथ क्लाउड फ़ंक्शन लॉग क्लाउड लॉगिंग द्वारा समर्थित हैं। आप Node.js के लिए क्लाउड लॉगिंग लाइब्रेरी का उपयोग संरचित डेटा के साथ ईवेंट लॉग करने के लिए कर सकते हैं, जिससे विश्लेषण और निगरानी आसान हो जाती है।

const { Logging } = require('@google-cloud/logging');

// ...

// Instantiate the logging SDK. The project ID will
// be automatically inferred from the Cloud Functions environment.
const logging = new Logging();
const log = logging.log('my-custom-log-name');

// This metadata is attached to each log entry. This specifies a fake
// Cloud Function called 'Custom Metrics' in order to make your custom
// log entries appear in the Cloud Functions logs viewer.
const METADATA = {
  resource: {
    type: 'cloud_function',
    labels: {
      function_name: 'CustomMetrics',
      region: 'us-central1'
    }
  }
};

// ...

// Data to write to the log. This can be a JSON object with any properties
// of the event you want to record.
const data = {
  event: 'my-event',
  value: 'foo-bar-baz',

  // Optional 'message' property will show up in the Firebase
  // console and other human-readable logging surfaces
  message: 'my-event: foo-bar-baz'
};

// Write to the log. The log.write() call returns a Promise if you want to
// make sure that the log was written successfully.
const entry = log.entry(METADATA, data);
log.write(entry);

console.log का उपयोग करना

किसी फ़ंक्शन से लॉगिंग के लिए अनुशंसित समाधान लॉगर एसडीके का उपयोग करना है। आप इसके बजाय मानक जावास्क्रिप्ट लॉगिंग कॉल जैसे कि console.log और console.error का उपयोग कर सकते हैं, लेकिन आपको पहले मानक विधियों को सही ढंग से काम करने के लिए पैच करने के लिए एक विशेष मॉड्यूल की आवश्यकता होती है:

require("firebase-functions/logger/compat");

एक बार जब आपको लॉगर संगतता मॉड्यूल की आवश्यकता हो, तो आप अपने कोड में सामान्य रूप से console.log() विधियों का उपयोग कर सकते हैं:

exports.helloError = functions.https.onRequest((request, response) => {
  console.log('I am a log entry!');
  response.send('Hello World...');
});
  • console.log() कमांड में INFO लॉग स्तर होता है।
  • console.info() कमांड में INFO लॉग लेवल होता है।
  • console.warn() कमांड में ERROR लॉग लेवल होता है।
  • console.error() कमांड में ERROR लॉग लेवल होता है।
  • आंतरिक सिस्टम संदेशों में DEBUG लॉग स्तर होता है।

लॉग देखना

क्लाउड फ़ंक्शंस के लिए लॉग या तो Google क्लाउड कंसोल , क्लाउड लॉगिंग UI में या firebase कमांड-लाइन टूल के माध्यम से देखे जा सकते हैं।

फायरबेस सीएलआई का उपयोग करना

firebase टूल के साथ लॉग देखने के लिए, functions:log कमांड:

firebase functions:log

किसी विशिष्ट फ़ंक्शन के लिए लॉग देखने के लिए, फ़ंक्शन नाम को तर्क के रूप में प्रदान करें:

firebase functions:log --only <FUNCTION_NAME>

लॉग देखने के विकल्पों की पूरी श्रृंखला के लिए, functions:log :

firebase help functions:log

Google क्लाउड कंसोल का उपयोग करना

आप Google क्लाउड कंसोल में कार्यों के लिए लॉग देख सकते हैं।

क्लाउड लॉगिंग UI का उपयोग करना

आप क्लाउड लॉगिंग UI में क्लाउड फ़ंक्शंस के लिए लॉग देख सकते हैं।

लॉग का विश्लेषण

क्लाउड लॉगिंग लॉग विश्लेषण टूल का एक शक्तिशाली सूट प्रदान करता है जिसका उपयोग आप अपने क्लाउड फ़ंक्शंस की निगरानी के लिए कर सकते हैं। कस्टम लॉगिंग के साथ संयुक्त होने पर ये उपकरण विशेष रूप से शक्तिशाली होते हैं।

लॉग-आधारित मेट्रिक्स

क्लाउड लॉगिंग UI में, लॉग स्कोप को उस फ़ंक्शन तक सीमित करने के लिए उन्नत फ़िल्टर फ़ील्ड का उपयोग करें जिसका आप विश्लेषण करना चाहते हैं, फिर लॉग को फ़िल्टर करने के लिए फ़िल्टर सबमिट करें पर क्लिक करें। उदाहरण के लिए, आप केवल एक फ़ंक्शन से लॉग का विश्लेषण कर सकते हैं:

resource.type="cloud_function"
resource.labels.function_name="myCloudFunction"
resource.labels.region="us-central1"

यदि आपने कस्टम JSON पेलोड के साथ ईवेंट लॉग किए हैं, तो आप अपने द्वारा प्रदान की गई कुंजियों और मानों का उपयोग करके फ़िल्टर कर सकते हैं:

resource.type="cloud_function"
resource.labels.function_name="CustomMetrics"
jsonPayload.event="my-event"

एक बार जब आप लॉग को फ़िल्टर कर लेते हैं, तो आप लॉग-आधारित मीट्रिक का उपयोग करके उनका विश्लेषण कर सकते हैं। मीट्रिक संपादक खोलने और मीट्रिक प्रकार चुनने के लिए मीट्रिक बनाएं बटन पर क्लिक करें:

  • काउंटर मेट्रिक्स: फ़िल्टर से मेल खाने वाली लॉग प्रविष्टियों की संख्या की गणना करें। उदाहरण के लिए आप किसी निश्चित घटना के घटित होने की संख्या की गणना कर सकते हैं।
  • वितरण मेट्रिक्स: फ़िल्टर से मेल खाने वाली लॉग प्रविष्टियों से संख्यात्मक डेटा जमा करें। उदाहरण के लिए आप अपने कार्यों के भीतर कुछ कार्यों की विलंबता को ट्रैक कर सकते हैं।

टेक्स्ट-आधारित लॉग के लिए, जैसे कि आपके फ़ंक्शन में कंसोल.लॉग console.log() के परिणामस्वरूप, आप रेगुलर एक्सप्रेशन का उपयोग करके textPayload फ़ील्ड से मान और लेबल निकाल सकते हैं। संरचित डेटा के साथ कस्टम लॉग के लिए आप सीधे jsonPayload फ़ील्ड में डेटा तक पहुँच सकते हैं।

चार्ट और अलर्ट

एक बार जब आप अपने कार्यों की निगरानी के लिए लॉग-आधारित मीट्रिक बना लेते हैं, तो आप इन मीट्रिक के आधार पर चार्ट और अलर्ट बना सकते हैं। उदाहरण के लिए, आप समय के साथ विलंबता की कल्पना करने के लिए एक चार्ट बना सकते हैं, या आपको यह बताने के लिए एक अलर्ट बना सकते हैं कि क्या कोई निश्चित त्रुटि बहुत बार होती है।

चार्ट और अलर्ट नीतियों में लॉग-आधारित मीट्रिक का उपयोग करने के तरीके के बारे में विस्तृत जानकारी के लिए चार्ट और अलर्ट बनाना देखें।