লগ লিখুন এবং দেখুন


লগিং ডিবাগিং এবং মনিটরিং কোডের জন্য একটি গুরুত্বপূর্ণ টুল। Cloud Functions আপনাকে এর লগার SDK, কাস্টম Google Cloud Logging বা ওয়েবের জন্য বিকাশের জন্য console অবজেক্ট স্ট্যান্ডার্ড ব্যবহার করার বিকল্প দেয়৷

লগ লেখা

যদিও বেশিরভাগ পরিস্থিতিতে Cloud Functions লগার SDK সুপারিশ করা হয়, আপনি এই কারণগুলির জন্য অন্য বিকল্পগুলির মধ্যে একটি বেছে নিতে পারেন:

  • আপনার একটি বিদ্যমান কোড বেস আছে এবং আপনি console.log থেকে রিফ্যাক্টর না করা পছন্দ করেন।
  • আপনি Cloud Logging (পূর্বে স্ট্যাকড্রাইভার লগিং) এর সাথে পরিচিত এবং কাস্টম লগিংয়ের জন্য এটি ব্যবহার করতে পছন্দ করেন।

Cloud Functions লগার SDK ব্যবহার করে৷

Cloud Functions লগার SDK একটি স্ট্যান্ডার্ড ইন্টারফেস প্রদান করে যেটিতে console.log স্টেটমেন্টের অনুরূপ api আছে এবং অন্যান্য লগ লেভেল সমর্থন করে। আপনি স্ট্রাকচার্ড ডেটা সহ ইভেন্ট লগ করতে এই SDK ব্যবহার করতে পারেন, সহজ বিশ্লেষণ এবং পর্যবেক্ষণ সক্ষম করে৷

লগার SDK একটি ওয়াইল্ডকার্ড আমদানির অংশ হিসাবে লগ এন্ট্রি সমর্থন করে৷ যেমন:

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

  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() কমান্ডের WARNING লগ লেভেল থাকে।
  • logger.error() কমান্ডের ERROR লগ লেভেল থাকে।
  • অভ্যন্তরীণ সিস্টেম বার্তাগুলির DEBUG লগ স্তর রয়েছে৷

logger.write() এর মাধ্যমে, আপনি CRITICAL , ALERT , এবং EMERGENCY এর লগ এন্ট্রি ছাড়াও লগের তীব্রতা লেভেল লিখতে পারেন। LogSeverity দেখুন।

কাস্টম Cloud Logging লগ

লগার SDK সহ Cloud Functions লগগুলি Cloud Logging দ্বারা সমর্থিত। আপনি স্ট্রাকচার্ড ডেটা সহ ইভেন্টগুলি লগ করার জন্য Node.js-এর জন্য Cloud Logging লাইব্রেরি ব্যবহার করতে পারেন, সহজ বিশ্লেষণ এবং পর্যবেক্ষণ সক্ষম করে৷

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 ব্যবহার করে

একটি ফাংশন থেকে লগিং করার জন্য প্রস্তাবিত সমাধান হল আপনার প্ল্যাটফর্মের জন্য লগার SDK ব্যবহার করা। Node.js এর সাথে, আপনি পরিবর্তে স্ট্যান্ডার্ড জাভাস্ক্রিপ্ট লগিং কলগুলি যেমন 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 লগ স্তর রয়েছে৷

লগ দেখা

Cloud Functions জন্য লগগুলি হয় Google Cloud কনসোলে , Cloud Logging UI, বা firebase কমান্ড-লাইন টুলের মাধ্যমে দেখা যায়৷

Firebase CLI ব্যবহার করে

firebase টুল দিয়ে লগ দেখতে, functions:log কমান্ড ব্যবহার করুন:

firebase functions:log

একটি নির্দিষ্ট ফাংশনের জন্য লগ দেখতে, একটি যুক্তি হিসাবে ফাংশন নাম প্রদান করুন:

firebase functions:log --only <FUNCTION_NAME>

লগ দেখার বিকল্পগুলির সম্পূর্ণ পরিসরের জন্য, functions:log :

firebase help functions:log

Google Cloud কনসোল ব্যবহার করে

আপনি Google Cloud কনসোলে ফাংশনের জন্য লগ দেখতে পারেন।

Cloud Logging UI ব্যবহার করা

আপনি Cloud Logging UI-তে Cloud Functions জন্য লগগুলি দেখতে পারেন৷

লগ বিশ্লেষণ

Cloud Logging লগ বিশ্লেষণ সরঞ্জামগুলির একটি শক্তিশালী স্যুট অফার করে যা আপনি আপনার Cloud Functions নিরীক্ষণ করতে ব্যবহার করতে পারেন৷

চার্ট এবং সতর্কতা

একবার আপনি আপনার ফাংশনগুলি নিরীক্ষণ করার জন্য লগ-ভিত্তিক মেট্রিক তৈরি করলে, আপনি এই মেট্রিকগুলির উপর ভিত্তি করে চার্ট এবং সতর্কতা তৈরি করতে পারেন। উদাহরণস্বরূপ, আপনি সময়ের সাথে লেটেন্সি কল্পনা করার জন্য একটি চার্ট তৈরি করতে পারেন, বা একটি নির্দিষ্ট ত্রুটি খুব ঘন ঘন ঘটলে আপনাকে জানানোর জন্য একটি সতর্কতা তৈরি করতে পারেন।

চার্ট এবং সতর্কতা নীতিতে লগ-ভিত্তিক মেট্রিক্স কীভাবে ব্যবহার করতে হয় সে সম্পর্কে বিস্তারিত তথ্যের জন্য চার্ট এবং সতর্কতা তৈরি করা দেখুন।

,


লগিং ডিবাগিং এবং মনিটরিং কোডের জন্য একটি গুরুত্বপূর্ণ টুল। Cloud Functions আপনাকে এর লগার SDK, কাস্টম Google Cloud Logging বা ওয়েবের জন্য বিকাশের জন্য console অবজেক্ট স্ট্যান্ডার্ড ব্যবহার করার বিকল্প দেয়৷

লগ লেখা

যদিও বেশিরভাগ পরিস্থিতিতে Cloud Functions লগার SDK সুপারিশ করা হয়, আপনি এই কারণগুলির জন্য অন্য বিকল্পগুলির মধ্যে একটি বেছে নিতে পারেন:

  • আপনার একটি বিদ্যমান কোড বেস আছে এবং আপনি console.log থেকে রিফ্যাক্টর না করা পছন্দ করেন।
  • আপনি Cloud Logging (পূর্বে স্ট্যাকড্রাইভার লগিং) এর সাথে পরিচিত এবং কাস্টম লগিংয়ের জন্য এটি ব্যবহার করতে পছন্দ করেন।

Cloud Functions লগার SDK ব্যবহার করে৷

Cloud Functions লগার SDK একটি স্ট্যান্ডার্ড ইন্টারফেস প্রদান করে যেটিতে console.log স্টেটমেন্টের অনুরূপ api আছে এবং অন্যান্য লগ লেভেল সমর্থন করে। আপনি স্ট্রাকচার্ড ডেটা সহ ইভেন্ট লগ করতে এই SDK ব্যবহার করতে পারেন, সহজ বিশ্লেষণ এবং পর্যবেক্ষণ সক্ষম করে৷

লগার SDK একটি ওয়াইল্ডকার্ড আমদানির অংশ হিসাবে লগ এন্ট্রি সমর্থন করে৷ যেমন:

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

  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() কমান্ডের WARNING লগ লেভেল থাকে।
  • logger.error() কমান্ডের ERROR লগ লেভেল থাকে।
  • অভ্যন্তরীণ সিস্টেম বার্তাগুলির DEBUG লগ স্তর রয়েছে৷

logger.write() এর মাধ্যমে, আপনি CRITICAL , ALERT , এবং EMERGENCY এর লগ এন্ট্রি ছাড়াও লগের তীব্রতা লেভেল লিখতে পারেন। LogSeverity দেখুন।

কাস্টম Cloud Logging লগ

লগার SDK সহ Cloud Functions লগগুলি Cloud Logging দ্বারা সমর্থিত। আপনি স্ট্রাকচার্ড ডেটা সহ ইভেন্টগুলি লগ করার জন্য Node.js-এর জন্য Cloud Logging লাইব্রেরি ব্যবহার করতে পারেন, সহজ বিশ্লেষণ এবং পর্যবেক্ষণ সক্ষম করে৷

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 ব্যবহার করে

একটি ফাংশন থেকে লগিং করার জন্য প্রস্তাবিত সমাধান হল আপনার প্ল্যাটফর্মের জন্য লগার SDK ব্যবহার করা। Node.js এর সাথে, আপনি পরিবর্তে স্ট্যান্ডার্ড জাভাস্ক্রিপ্ট লগিং কলগুলি যেমন 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 লগ স্তর রয়েছে৷

লগ দেখা

Cloud Functions জন্য লগগুলি হয় Google Cloud কনসোলে , Cloud Logging UI, বা firebase কমান্ড-লাইন টুলের মাধ্যমে দেখা যায়৷

Firebase CLI ব্যবহার করে

firebase টুল দিয়ে লগ দেখতে, functions:log কমান্ড ব্যবহার করুন:

firebase functions:log

একটি নির্দিষ্ট ফাংশনের জন্য লগ দেখতে, একটি যুক্তি হিসাবে ফাংশন নাম প্রদান করুন:

firebase functions:log --only <FUNCTION_NAME>

লগ দেখার বিকল্পগুলির সম্পূর্ণ পরিসরের জন্য, functions:log :

firebase help functions:log

Google Cloud কনসোল ব্যবহার করে

আপনি Google Cloud কনসোলে ফাংশনের জন্য লগ দেখতে পারেন।

Cloud Logging UI ব্যবহার করা

আপনি Cloud Logging UI-তে Cloud Functions জন্য লগগুলি দেখতে পারেন৷

লগ বিশ্লেষণ

Cloud Logging লগ বিশ্লেষণ সরঞ্জামগুলির একটি শক্তিশালী স্যুট অফার করে যা আপনি আপনার Cloud Functions নিরীক্ষণ করতে ব্যবহার করতে পারেন৷

চার্ট এবং সতর্কতা

একবার আপনি আপনার ফাংশনগুলি নিরীক্ষণ করার জন্য লগ-ভিত্তিক মেট্রিক তৈরি করলে, আপনি এই মেট্রিকগুলির উপর ভিত্তি করে চার্ট এবং সতর্কতা তৈরি করতে পারেন। উদাহরণস্বরূপ, আপনি সময়ের সাথে লেটেন্সি কল্পনা করার জন্য একটি চার্ট তৈরি করতে পারেন, বা একটি নির্দিষ্ট ত্রুটি খুব ঘন ঘন ঘটলে আপনাকে জানানোর জন্য একটি সতর্কতা তৈরি করতে পারেন।

চার্ট এবং সতর্কতা নীতিতে লগ-ভিত্তিক মেট্রিক্স কীভাবে ব্যবহার করতে হয় সে সম্পর্কে বিস্তারিত তথ্যের জন্য চার্ট এবং সতর্কতা তৈরি করা দেখুন।