লগ লিখুন এবং দেখুন (1ম প্রজন্ম)

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

লগ লেখা

যদিও বেশিরভাগ ক্ষেত্রে Cloud Functions লগার এসডিকে ব্যবহার করার পরামর্শ দেওয়া হয়, তবুও আপনি নিম্নলিখিত কারণগুলোর জন্য অন্য কোনো বিকল্প বেছে নিতে পারেন:

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

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

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

লগার এসডিকে ওয়াইল্ডকার্ড ইম্পোর্টের অংশ হিসেবে লগ এন্ট্রি সমর্থন করে। উদাহরণস্বরূপ:

  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);
index.js

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...');
});
index.js

• console.log() কমান্ডগুলোর লগ লেভেল হলো INFO ।
• console.info() কমান্ডগুলোর লগ লেভেল হলো INFO ।
• console.warn() কমান্ডগুলোর লগ লেভেল হলো ERROR ।
• console.error() কমান্ডগুলোর লগ লেভেল হলো ERROR ।
• অভ্যন্তরীণ সিস্টেম বার্তাগুলোর লগ লেভেল হলো DEBUG ।

লগ দেখা

Cloud Functions লগগুলো Google Cloud কনসোল , Cloud Logging ইউআই, অথবা firebase কমান্ড-লাইন টুলের মাধ্যমে দেখা যায়।

ফায়ারবেস সিএলআই ব্যবহার করে

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 নিরীক্ষণ করতে পারেন।

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

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

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