Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Gap]: Document console usage and event retention for both gateways

オープン
#1,243 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
62/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
helm
領域
documentation

調査の方向性

Start with the existing Connector Gateway Tool Usage and Activity pages, the AI Gateway budget guides, the Enterprise Manager Helm reference, and the audit-log forwarding guides, and search them for retention wording. Add a section that covers each listed point: the four-week default, weekly partitions, both retention settings, the captured-text window, and the note that the three-month chart does not extend history. Done means every point appears with the correct setting names, and the Helm guidance states that a dedicated Connector Gateway setting is not yet available.

索引モデルが issue の本文から書いたものです。

説明

documentation enhancement needs-triage
What needs documentation?

Document retention for the usage metrics and event history backing the Connector Gateway and AI Gateway console views, including defaults, supported configuration, and cleanup behavior.

Cover:

  • Both gateways default to four weeks of event retention, configurable from 1–12 weeks.
  • Retention uses weekly UTC partitions: four complete previous weeks plus the current week, with hourly cleanup by default, rather than an exact rolling 28-day deletion cutoff.
  • AI Gateway usage/spend retention is configured through enterprise-manager.appConfig.budgets.retentionWeeks.
  • Connector Gateway tool-call usage/activity retention currently uses the Enterprise Manager environment variable ENTERPRISE_METERING_PARTMAN_RETENTION_WEEKS, supplied through enterprise-manager.extraEnv when using Helm. Document a dedicated Helm setting when it becomes available in a released version.
  • Budget totals and dimension counters survive event partition cleanup; explain which views remain available and which depend on retained events.
  • Captured AI conversation text, when enabled, has independent retention: seven days after the last turn by default, configurable through appConfig.budgets.captureInactivityWindow, capped at thirty days.
  • External audit-log retention is controlled by the operator's log pipeline/SIEM and is separate from console-data retention.

Explain that selecting a three-month chart window does not extend stored history. The Connector Gateway Tool Usage page currently describes a three-month trend without explaining the four-week storage default.

Context and references

The relevant documentation includes the Connector Gateway Tool Usage and connector Activity guidance, the AI Gateway budget guides, and the Enterprise Manager Helm reference. Both gateways already have audit-log forwarding guides that describe externally managed retention, but those guides do not cover console-data storage.

Use case

As a platform operator, I need to know how much usage and activity history the console keeps, how to configure that window, and whether older aggregate totals remain available. This helps me size database storage, interpret incomplete chart history, and decide whether I need an external audit archive for longer retention.

Additional context

Documentation coverage checked on October 15, 2026. The docs contain references to retention clamping in generated API descriptions and generic appConfig/extraEnv Helm guidance, but no operator-facing explanation of these defaults and settings.

Document the supported configuration for the released platform version. Document a dedicated Connector Gateway retention Helm setting when available; existing retention behavior can be documented independently.

主要言語
JavaScript
スター
4
フォーク
4
平均マージ
1日 1時間
マージ済み PR(30日)
58

環境構築

Codespaces で開く

このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

stacklok/docs-website のほかの issue

stacklok/docs-website の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。