diff options
| author | Jerop Kipruto <[email protected]> | 2025-06-15 16:24:53 -0400 |
|---|---|---|
| committer | GitHub <[email protected]> | 2025-06-15 13:24:53 -0700 |
| commit | 714421c2da4f5d6b9c1c7060fdf5c47ba1c965ca (patch) | |
| tree | 488459669757dda99eda46b621a030ece38842dd /docs/core | |
| parent | 4421ef126fc6a2de89132aa35c261bf78cd481d2 (diff) | |
Add file operation telemetry (#1068)
Introduces telemetry for file create, read, and update operations.
This change adds the `gemini_cli.file.operation.count` metric, recorded by the `read-file`, `read-many-files`, and `write-file` tools.
The metric includes the following attributes:
- `operation` (string: `create`, `read`, `update`): The type of file operation.
- `lines` (optional, Int): Number of lines in the file.
- `mimetype` (optional, string): Mimetype of the file.
- `extension` (optional, string): File extension of the file.
Here is a stacked bar chart of file operations by extension (`js`, `ts`, `md`):

Here is a stacked bar chart of file operations by type (`create`, `read`, `update`):

#750
cc @allenhutchison as discussed
Diffstat (limited to 'docs/core')
| -rw-r--r-- | docs/core/telemetry.md | 9 |
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/core/telemetry.md b/docs/core/telemetry.md index c42c2ed6..42719db5 100644 --- a/docs/core/telemetry.md +++ b/docs/core/telemetry.md @@ -273,6 +273,15 @@ These are numerical measurements of behavior over time. - `model` - `gemini_cli.token.usage` (Counter, Int): Counts the number of tokens used. + - **Attributes**: - `model` - `type` (string: "input", "output", "thought", "cache", or "tool") + +- `gemini_cli.file.operation.count` (Counter, Int): Counts file operations. + + - **Attributes**: + - `operation` (string: "create", "read", "update"): The type of file operation. + - `lines` (optional, Int): Number of lines in the file. + - `mimetype` (optional, string): Mimetype of the file. + - `extension` (optional, string): File extension of the file. |
