@google-cloud/logging

What is @google-cloud/logging?

The @google-cloud/logging package is a client library for Google Cloud Logging, part of Google Cloud's suite of services for storing, searching, analyzing, monitoring, and alerting on log data from Google Cloud and Amazon Web Services. It allows developers to integrate their applications with the Google Cloud Logging service easily, enabling them to send logs directly from their applications to the cloud.

What are @google-cloud/logging's main functionalities?

Writing Log Entries

This feature allows users to write log entries to Google Cloud Logging. The code sample demonstrates how to create a log entry and write it to a specified log in Google Cloud.

const {Logging} = require('@google-cloud/logging');
const logging = new Logging();
const log = logging.log('my-log');
const metadata = {resource: {type: 'global'}};
const entry = log.entry(metadata, {message: 'Hello, world!'});
async function writeLog() {
  await log.write(entry);
  console.log('Logged: Hello, world!');
}
writeLog();

Listing Logs

This feature enables the listing of all logs in the Google Cloud Logging account. The code sample shows how to retrieve and print the names of all logs.

const {Logging} = require('@google-cloud/logging');
const logging = new Logging();
async function listLogs() {
  const [logs] = await logging.getLogs();
  console.log('Logs:');
  logs.forEach(log => {
    console.log(log.name);
  });
}
listLogs();

Deleting Logs

This feature allows users to delete logs from Google Cloud Logging. The code sample illustrates how to delete a specific log by its name.

const {Logging} = require('@google-cloud/logging');
const logging = new Logging();
const log = logging.log('my-log');
async function deleteLog() {
  await log.delete();
  console.log('Log deleted.');
}
deleteLog();

Other packages similar to @google-cloud/logging

winston

Winston is a versatile logging library for Node.js. Unlike @google-cloud/logging, which is specifically designed for integration with Google Cloud Logging, Winston supports multiple transports (a way to store logs) such as files, console, and more. It is more flexible for various logging needs and environments but doesn't provide direct integration with Google Cloud Logging without additional plugins.

bunyan

Bunyan is another Node.js logging library that focuses on JSON logging. Like Winston, it is highly configurable and supports various outputs but does not have built-in support for Google Cloud Logging. It is comparable to @google-cloud/logging in terms of providing structured logging but is more general-purpose.

README

The README file is missing

Changelog

10.2.0 (2022-10-27)

Features

• Add support for partialSuccess global configuration (#1359) (178b19f)