Installations

npm install @relaycorp/pino-cloud

Developer Guide

BETA

Typescript

No

Module System

CommonJS

Min. Node Version

>=14

Node Version

14.21.1

NPM Version

6.14.17 Pull Requests

Open

5

Total

318

Closed

70

Merged

243

Issues

Open

0

Total

4

Closed

4

Releases

29

v1.0.28

Updated on Jan 02, 2023

v1.0.27

Updated on Nov 28, 2022

v1.0.26

Updated on Oct 03, 2022

v1.0.25

Updated on Sep 19, 2022

v1.0.24

Updated on Sep 05, 2022

v1.0.23

Updated on Aug 22, 2022

View All 29 releases

Languages

2

TypeScript

JavaScript

TypeScript (51.93%)

JavaScript (48.07%)

Developer

relaycorp

Download Statistics

Total Downloads

0

Last Day

0

Last Week

0

Last Month

0

Last Year

0

GitHub Statistics

MIT License

11 Stars

259 Commits

1 Watchers

7 Branches

2 Contributors

Updated on Mar 31, 2025

Maintainers

2

View All 2 Contributors

Package Meta Information

Latest Version

1.0.28

Package Id

@relaycorp/pino-cloud@1.0.28

Unpacked Size

14.40 kB

Size

5.08 kB

File Count

31

NPM Version

6.14.17

Node Version

14.21.1

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

0%

NaN

Compared to previous day

Last Week

0%

NaN

Compared to previous week

Last Month

0%

NaN

Compared to previous month

Last Year

0%

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

1

pino

Peer Dependencies

1

pino

Dev Dependencies

12

@relaycorp/shared-config @types/jest del-cli jest jest-extended npm-run-all prettier ts-jest ts-node tslint typedoc typescript

@relaycorp/pino-cloud

This library generates Pino configuration to format log entries in such a way that they can be properly ingested by cloud logging services such as those on Google Cloud Platform (GCP).

At this point, only GCP's Cloud Logging and Error Reporting services are supported, but we'd welcome any PRs to support additional targets, such as Elastic Search or AWS CloudWatch Logs.

Install

Releases are automatically pushed to NPM. For example, to get the latest release, run:

1npm install @relaycorp/pino-cloud

Usage

This library simply returns a configuration object for Pino, which you augment before passing to Pino. For example:

1import { getPinoOptions } from '@relaycorp/pino-cloud';
2
3const LOGGER = pino({
4  ...getPinoOptions(process.ENV.LOGGING_TARGET, {
5    name: 'your-app-name',
6    version: '1.0.2',
7  }),
8  level: 'debug',
9});

If the environment variable LOGGING_TARGET is unset, an empty object is returned.

Targets

`gcp`

error and fatal logs are augmented to include Error Reporting fields, like the name and version of your app.

Additionally, if the log contains an err field that is an instance of Error, its stack trace will be added to the field stack_trace -- Where Error Reporting expects to find it.

API documentation

The API documentation can be found on docs.relaycorp.tech.

Contributing

We love contributions! If you haven't contributed to a Relaycorp project before, please take a minute to read our guidelines first.

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

4.4

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More