Child Loggers

Child loggers in Hive Logger allow you to create new logger instances that inherit configuration (such as log level, writers, and attributes) from their parent logger. This is useful for associating contextual information (like request IDs or component names) with all logs from a specific part of your application.

When you create a child logger using the child method, you can:

  • Add a prefix to all log messages from the child logger.
  • Add attributes that will be included in every log entry from the child logger.
  • Inherit the log level and writers from the parent logger, unless explicitly changed on the child.

This makes it easy to organize and structure logs in complex applications, ensuring that related logs carry consistent context.

For example, running this:

import { Logger } from "@graphql-hive/logger";

const log = new Logger();

const child = log.child({ requestId: "123-456" }, "[child] ");

child.info("Hello World!");
child.info({ requestId: "overwritten attribute" });

const nestedChild = child.child({ traceId: "789-012" }, "[nestedChild] ");

nestedChild.info("Hello Deep Down!");

Will output:

2025-04-10T14:00:00.000Z INF [child] Hello World!
  requestId: "123-456"
2025-04-10T14:00:00.000Z INF [child]
  requestId: "overwritten attribute"
2025-04-20T18:39:30.291Z INF [child] [nestedChild] Hello Deep Down!
  requestId: "123-456"
  traceId: "789-012"