কোড ডিবাগ ও মনিটর করার জন্য লগিং একটি গুরুত্বপূর্ণ টুল।
Cloud Functions আপনাকে এর লগার SDK, কাস্টম Google
Cloud Logging বা ওয়েব ডেভেলপ করার জন্য console অবজেক্ট স্ট্যান্ডার্ড ব্যবহার করার বিকল্প দেয়।
লগ লেখা হচ্ছে
বেশিরভাগ ক্ষেত্রে Cloud Functions লগার SDK সাজেস্ট করা হলেও, আপনি এইসব কারণে অন্যান্য বিকল্পের মধ্যে থেকে একটি বেছে নিতে পারেন:
- আপনার কাছে আগে থেকেই একটি কোড বেস আছে এবং আপনি
console.logথেকে রিফ্যাক্টর করতে চান না। - আপনি Cloud Logging (আগে StackDriver 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()টি কমান্ডে সতর্কতা লগ লেভেল আছে।logger.error()কমান্ডে ERROR লগ লেভেল আছে।- ইন্টার্নাল সিস্টেম মেসেজে DEBUG লগ লেভেল থাকে।
logger.write()-এর সাহায্যে, আপনি CRITICAL, ALERT এবং EMERGENCY-এর
লগ তীব্রতা লেভেল ছাড়াও লগ এন্ট্রি লিখতে পারবেন। LogSeverity দেখুন।
কাস্টম Cloud Logging লগ
লগার SDK-এর সাথে Cloud Functionsটি লগ Cloud Logging-এর মাধ্যমে ব্যাক-আপ নেওয়া হয়। আপনি Cloud Logging 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 ব্যবহৃত হচ্ছে
কোনও ফাংশন থেকে লগ করার জন্য আপনার প্ল্যাটফর্মের লগার 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 মনিটর করতে ব্যবহার করতে পারেন।
চার্ট ও সতর্কতা
আপনার ফাংশন মনিটর করার জন্য লগ-ভিত্তিক মেট্রিক তৈরি করার পরে, আপনি এইসব মেট্রিকের ভিত্তিতে চার্ট ও সতর্কতা তৈরি করতে পারবেন। যেমন, সময়ের সাথে সাথে লেটেন্সি ভিজ্যুয়ালাইজ করার জন্য আপনি চার্ট তৈরি করতে পারেন অথবা নির্দিষ্ট কোনও সমস্যা ঘন ঘন হলে আপনাকে জানানোর জন্য অ্যালার্ট তৈরি করতে পারেন।
চার্ট ও সতর্কতা সংক্রান্ত নীতিতে কীভাবে লগ-ভিত্তিক মেট্রিক ব্যবহার করতে হয় সেই সম্পর্কে বিস্তারিত তথ্যের জন্য চার্ট ও সতর্কতা তৈরি করা দেখুন।