Skip to content

docs: document Log Analytics prerequisite for metric charts (refs #6)#7

Open
lokic233 wants to merge 1 commit into
AI-Hypercomputer:mainfrom
lokic233:docs/log-analytics-prerequisite
Open

docs: document Log Analytics prerequisite for metric charts (refs #6)#7
lokic233 wants to merge 1 commit into
AI-Hypercomputer:mainfrom
lokic233:docs/log-analytics-prerequisite

Conversation

@lokic233

Copy link
Copy Markdown

Summary

Documents an undocumented prerequisite: the ML Diagnostics model-metrics / performance-metrics time series charts render their data via a Log Analytics query over the project's _Default log bucket. If Log Analytics is not enabled on that bucket, those charts fail with a generic "Something went wrong in the backend" / "0 time series" — even though the metric data is present in Cloud Logging and Profiles / system metrics render fine.

Adds a note to the Viewing Logs, Metrics and Profiles section covering:

  • the one-time enable command (gcloud logging buckets update _Default --location=global --enable-analytics),
  • the required permission (logging.buckets.update / roles/logging.configWriter), and
  • the no-backfill caveat (only logs ingested after enabling are queryable; verify with a new run).

Docs-only change.

Refs #6

The model-metrics / performance-metrics time series charts render via a Log
Analytics query over the project's _Default log bucket. If Log Analytics is
not enabled on that bucket the charts fail with a generic 'Something went
wrong in the backend' / '0 time series', even though the metric data is
present in Cloud Logging and Profiles / system metrics render.

Document the one-time 'gcloud logging buckets update _Default
--enable-analytics' prerequisite, the required permission, and the
no-backfill behavior.

Refs AI-Hypercomputer#6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant