File size: 3,485 Bytes
7a1ad33 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 | /**
* @license
* Copyright 2025 Google LLC
* SPDX-License-Identifier: Apache-2.0
*/
import type { TelemetrySettings } from '../config/config.js';
import { FatalConfigError } from '../utils/errors.js';
import { TelemetryTarget } from './index.js';
/**
* Parse a boolean environment flag. Accepts 'true'/'1' as true.
*/
export function parseBooleanEnvFlag(
value: string | undefined,
): boolean | undefined {
if (value === undefined) return undefined;
return value === 'true' || value === '1';
}
/**
* Normalize a telemetry target value into TelemetryTarget or undefined.
*/
export function parseTelemetryTargetValue(
value: string | TelemetryTarget | undefined,
): TelemetryTarget | undefined {
if (value === undefined) return undefined;
if (value === TelemetryTarget.LOCAL || value === 'local') {
return TelemetryTarget.LOCAL;
}
if (value === TelemetryTarget.GCP || value === 'gcp') {
return TelemetryTarget.GCP;
}
return undefined;
}
export interface TelemetryArgOverrides {
telemetry?: boolean;
telemetryTarget?: string | TelemetryTarget;
telemetryOtlpEndpoint?: string;
telemetryOtlpProtocol?: string;
telemetryLogPrompts?: boolean;
telemetryOutfile?: string;
}
/**
* Build TelemetrySettings by resolving from argv (highest), env, then settings.
*/
export async function resolveTelemetrySettings(options: {
argv?: TelemetryArgOverrides;
env?: Record<string, string | undefined>;
settings?: TelemetrySettings;
}): Promise<TelemetrySettings> {
const argv = options.argv ?? {};
const env = options.env ?? {};
const settings = options.settings ?? {};
const enabled =
argv.telemetry ??
parseBooleanEnvFlag(env['GEMINI_TELEMETRY_ENABLED']) ??
settings.enabled;
const traces =
parseBooleanEnvFlag(env['GEMINI_TELEMETRY_TRACES_ENABLED']) ??
settings.traces;
const rawTarget =
argv.telemetryTarget ??
env['GEMINI_TELEMETRY_TARGET'] ??
(settings.target as string | TelemetryTarget | undefined);
const target = parseTelemetryTargetValue(rawTarget);
if (rawTarget !== undefined && target === undefined) {
throw new FatalConfigError(
`Invalid telemetry target: ${String(
rawTarget,
)}. Valid values are: local, gcp`,
);
}
const otlpEndpoint =
argv.telemetryOtlpEndpoint ??
env['GEMINI_TELEMETRY_OTLP_ENDPOINT'] ??
env['OTEL_EXPORTER_OTLP_ENDPOINT'] ??
settings.otlpEndpoint;
const rawProtocol =
argv.telemetryOtlpProtocol ??
env['GEMINI_TELEMETRY_OTLP_PROTOCOL'] ??
settings.otlpProtocol;
const otlpProtocol = (['grpc', 'http'] as const).find(
(p) => p === rawProtocol,
);
if (rawProtocol !== undefined && otlpProtocol === undefined) {
throw new FatalConfigError(
`Invalid telemetry OTLP protocol: ${String(
rawProtocol,
)}. Valid values are: grpc, http`,
);
}
const logPrompts =
argv.telemetryLogPrompts ??
parseBooleanEnvFlag(env['GEMINI_TELEMETRY_LOG_PROMPTS']) ??
settings.logPrompts;
const outfile =
argv.telemetryOutfile ??
env['GEMINI_TELEMETRY_OUTFILE'] ??
settings.outfile;
const useCollector =
parseBooleanEnvFlag(env['GEMINI_TELEMETRY_USE_COLLECTOR']) ??
settings.useCollector;
return {
enabled,
traces,
target,
otlpEndpoint,
otlpProtocol,
logPrompts,
outfile,
useCollector,
useCliAuth:
parseBooleanEnvFlag(env['GEMINI_TELEMETRY_USE_CLI_AUTH']) ??
settings.useCliAuth,
};
}
|