Skip to content

Chrome DevTools for coding agents

feat: add an error logging method (#2006)

yulunz06e0ab602258
diff --git a/src/telemetry/ClearcutLogger.ts b/src/telemetry/ClearcutLogger.ts
index 6d9d6499..25704ead 100644
--- a/src/telemetry/ClearcutLogger.ts
+++ b/src/telemetry/ClearcutLogger.ts
@@ -10,6 +10,7 @@ import {DAEMON_CLIENT_NAME} from '../daemon/utils.js';
import {logger} from '../logger.js';
import type {zod, ShapeOutput} from '../third_party/index.js';
+import type {ErrorCode} from './errors.js';
import type {LocalState, Persistence} from './persistence.js';
import {FilePersistence} from './persistence.js';
import {
@@ -310,6 +311,22 @@ export class ClearcutLogger {
}
}
+ async logServerError(args: {
+ toolName?: string;
+ errorCode: ErrorCode;
+ }): Promise<void> {
+ this.#watchdog.send({
+ type: WatchdogMessageType.LOG_EVENT,
+ payload: {
+ mcp_client: this.#mcpClient,
+ server_error: {
+ tool_name: args.toolName ?? '',
+ error_code: args.errorCode,
+ },
+ },
+ });
+ }
+
#shouldLogDailyActive(state: LocalState): boolean {
if (!state.lastActive) {
return true;
diff --git a/src/telemetry/errors.ts b/src/telemetry/errors.ts
new file mode 100644
index 00000000..e318fe08
--- /dev/null
+++ b/src/telemetry/errors.ts
@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * IMPORTANT:
+ * 1. this module must only contain ErrorCode.
+ * 2. do not refactor ErrorCode to elsewhere.
+ */
+
+export enum ErrorCode {
+ ERROR_CODE_UNSPECIFIED = 0,
+}
diff --git a/src/telemetry/types.ts b/src/telemetry/types.ts
index 0b00ef2d..0f941335 100644
--- a/src/telemetry/types.ts
+++ b/src/telemetry/types.ts
@@ -4,6 +4,8 @@
* SPDX-License-Identifier: Apache-2.0
*/
+import type {ErrorCode} from './errors.js';
+
// Protobuf message interfaces
export interface ChromeDevToolsMcpExtension {
os_type?: OsType;
@@ -14,6 +16,12 @@ export interface ChromeDevToolsMcpExtension {
server_start?: ServerStart;
daily_active?: DailyActive;
server_shutdown?: ServerShutdown;
+ server_error?: ServerError;
+}
+
+export interface ServerError {
+ tool_name?: string;
+ error_code: ErrorCode;
}
export type ServerShutdown = Record<string, never>;
diff --git a/tests/telemetry/ClearcutLogger.test.ts b/tests/telemetry/ClearcutLogger.test.ts
index e88c0401..cab0f447 100644
--- a/tests/telemetry/ClearcutLogger.test.ts
+++ b/tests/telemetry/ClearcutLogger.test.ts
@@ -14,9 +14,10 @@ import {
ClearcutLogger,
sanitizeParams,
} from '../../src/telemetry/ClearcutLogger.js';
+import {ErrorCode} from '../../src/telemetry/errors.js';
import type {Persistence} from '../../src/telemetry/persistence.js';
import {FilePersistence} from '../../src/telemetry/persistence.js';
-import {WatchdogMessageType} from '../../src/telemetry/types.js';
+import {McpClient, WatchdogMessageType} from '../../src/telemetry/types.js';
import {WatchdogClient} from '../../src/telemetry/WatchdogClient.js';
import {zod} from '../../src/third_party/index.js';
@@ -126,6 +127,59 @@ describe('ClearcutLogger', () => {
}
});
+ describe('logServerError', () => {
+ it('sends correct payload with toolName', async () => {
+ const logger = ClearcutLogger.initialize({
+ persistence: mockPersistence,
+ appVersion: '1.0.0',
+ watchdogClient: mockWatchdogClient,
+ });
+
+ await logger.logServerError({
+ toolName: 'my_tool',
+ errorCode: ErrorCode.ERROR_CODE_UNSPECIFIED,
+ });
+
+ assert(mockWatchdogClient.send.calledOnce);
+ const msg = mockWatchdogClient.send.firstCall.args[0];
+ assert.deepStrictEqual(msg, {
+ type: WatchdogMessageType.LOG_EVENT,
+ payload: {
+ mcp_client: McpClient.MCP_CLIENT_UNSPECIFIED,
+ server_error: {
+ tool_name: 'my_tool',
+ error_code: ErrorCode.ERROR_CODE_UNSPECIFIED,
+ },
+ },
+ });
+ });
+
+ it('sends correct payload without toolName defaulting to empty string', async () => {
+ const logger = ClearcutLogger.initialize({
+ persistence: mockPersistence,
+ appVersion: '1.0.0',
+ watchdogClient: mockWatchdogClient,
+ });
+
+ await logger.logServerError({
+ errorCode: ErrorCode.ERROR_CODE_UNSPECIFIED,
+ });
+
+ assert(mockWatchdogClient.send.calledOnce);
+ const msg = mockWatchdogClient.send.firstCall.args[0];
+ assert.deepStrictEqual(msg, {
+ type: WatchdogMessageType.LOG_EVENT,
+ payload: {
+ mcp_client: McpClient.MCP_CLIENT_UNSPECIFIED,
+ server_error: {
+ tool_name: '',
+ error_code: ErrorCode.ERROR_CODE_UNSPECIFIED,
+ },
+ },
+ });
+ });
+ });
+
describe('logServerStart', () => {
it('logs flag usage', async () => {
const logger = ClearcutLogger.initialize({