util/log,cli: new TELEMETRY channel

[exalate-issue-sync]

Jesse Seldess (jseldess) commented:

PR: cockroachdb/cockroach#66427

From release notes:

CockroachDB now supports a new logging channel called TELEMETRY. This will be used in later versions to report diagnostic events useful to Cockroach Labs for product analytics. (At the time of this writing, no events are defined for the TELEMETRY channel yet.) When no logging configuration is specified, this channel is connected to file output, with a maximum retention of 1MiB. To also produce the diagnostic output elsewhere, one can [define a new sink](../v21.2/configure-logs.html] that captures this channel. For example, to see diagnostics reports on the standard error, one can use: --log='sinks: {stderr: {channels: TELEMETRY, filter: INFO}}' When configuring file output, the operator should be careful to apply a separate maximum retention for the TELEMETRY channel from other file outputs, as telemetry data can be verbose and outcrowd other logging messages. For example: --log='sinks: {file-groups: {telemetry: {channels: TELEMETRY, max-group-size: 1MB}, ...}}. [#66427][#66427)

Jira Issue: DOC-1359

[mari-crl]

This issue is an accidental duplicate created by automation. The correct issue that is synced to the corresponding Jira issue is #11523.