Analytics Section Migration

[Ethan-Arrowood]

Analytics Section Migration

Summary

Migration of Analytics documentation from versioned_docs/ into the new v4 consolidated reference structure.

Files Created

• reference_versioned_docs/version-v4/analytics/overview.md
• reference_versioned_docs/version-v4/analytics/operations.md

Source Files Used

analytics/overview.md

• versioned_docs/version-4.7/reference/analytics.md (primary — full analytics overview, tables, metrics)
• release-notes/v4-tucker/4.5.0.md (confirmed resource and storage analytics added)
• release-notes/v4-tucker/4.7.0.md (confirmed new analytics/licensing functionality)

analytics/operations.md

• versioned_docs/version-4.7/developers/operations-api/analytics.md (primary — get_analytics, list_metrics, describe_metric)
• versioned_docs/version-4.7/reference/analytics.md (for metric name context)

Version Annotations Added

High Confidence (Confirmed via release notes)

• Resource and storage analytics: Added in v4.5.0

Needs Verification

• get_analytics, list_metrics, describe_metric operations: Present in v4.7 ops API docs. The 4.7.0 release notes mention "new analytics and licensing functionality" but it's unclear if these operations were introduced in 4.7.0 or earlier. Marked with Added in: v4.5.0 on the overview (when the analytics feature was introduced) but the specific operations page does not carry a version annotation since the exact introduction version is uncertain. Human reviewer should verify and add annotations to operations.md as appropriate.

Link Placeholders Created

See migration-context/link-placeholders/analytics-link-placeholders.md for complete list.

Summary:

• 3 placeholders to http/api.md (file already exists — can be resolved now)
• 2 placeholders to logging/configuration.md (migrated in PR Logging Section Migration #450)
• 2 placeholders to configuration/overview.md
• 1 placeholder to operations-api/operations.md
• 1 placeholder to operations-api/overview.md

Images/Assets Noted

None.

Conflicts & Questions for Human Review

Uncertainties

• The 4.7.0 release notes mention "new analytics and licensing functionality for integration with Fabric services." It's not clear what specific changes this refers to in the public analytics API (vs internal Fabric integration). Human reviewer should assess whether additional content is needed to reflect v4.7 analytics changes.
• analytics.aggregatePeriod config option is mentioned in the overview but not fully documented — it belongs in the Configuration section. Referenced with a TODO link to configuration/overview.md.

Migration Map Status

Updated overview.md and operations.md to "In Progress"

Checklist for Human Reviewer

• Verify when get_analytics, list_metrics, describe_metric operations were introduced
• Clarify what changed in analytics in v4.7.0 (Fabric integration vs public API changes)
• Resolve http/api.md link placeholders (file already exists)
• Review content accuracy and completeness
• Update migration-map.md status to "Complete" after merge

🤖 Generated with Claude Code

[github-actions]

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-451

This preview will update automatically when you push new commits.

[github-actions]

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-451

This preview will update automatically when you push new commits.

[kriszyp]

This looks great. I think one of the AI questions was when analytics operations were added. The analytics operations were added in 4.6. (and yes, analytics capture and querying directly through the tables as available well before that; I actually thought we added it in 4.2, but not sure).

[github-actions]

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-451

This preview will update automatically when you push new commits.