summaryrefslogtreecommitdiff
path: root/docs/core
diff options
context:
space:
mode:
authorJerop Kipruto <[email protected]>2025-06-15 16:24:53 -0400
committerGitHub <[email protected]>2025-06-15 13:24:53 -0700
commit714421c2da4f5d6b9c1c7060fdf5c47ba1c965ca (patch)
tree488459669757dda99eda46b621a030ece38842dd /docs/core
parent4421ef126fc6a2de89132aa35c261bf78cd481d2 (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`): ![image](https://github.com/user-attachments/assets/3e8f8ea9-6155-4186-863c-075cc47647c5) Here is a stacked bar chart of file operations by type (`create`, `read`, `update`): ![image](https://github.com/user-attachments/assets/3fcf491d-31d0-4ba8-80e6-7fd2bd9c7c27) #750 cc @allenhutchison as discussed
Diffstat (limited to 'docs/core')
-rw-r--r--docs/core/telemetry.md9
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.