* chore(v2): Port main telemetry page content to a v2-specific docs page
* Update content/influxdb/v2/reference/telemetry.md
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
---------
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
- Move feature flag configuration from Advanced section into Step 3 of installation
- Update terminology from "Grafana OSS" to "running Grafana locally" to include both OSS and Enterprise
- Consolidate "Using Grafana Cloud with local InfluxDB" guidance into single note with direct link
- Remove redundant Advanced configuration section
Changes apply to all Grafana documentation pages:
- InfluxDB 3 products (Core, Enterprise, Cloud Serverless, Cloud Dedicated, Clustered)
- InfluxDB v2 and Cloud TSM
- InfluxDB v1 OSS and Enterprise
The feature flag requirement is now integrated directly into the installation workflow,
making it more discoverable for users setting up Grafana locally.
- Combine separate 'Query' and 'Build visualizations' sections into unified 'Query and visualize data' section
- Convert h2 headings to h3 under new parent section
- Update TOC to reflect new heading hierarchy
- Ensure all fragment links work correctly
Add note to all Grafana integration pages about using Grafana Cloud
with local InfluxDB instances. The note recommends running Grafana
locally to avoid exposing databases to the internet, and provides
information about configuring Grafana Cloud private data sources
as an alternative.
Updated files:
- content/shared/v3-process-data/visualize/grafana.md
- content/shared/influxdb-v2/tools/grafana.md
- content/influxdb/v1/tools/grafana.md
- content/enterprise_influxdb/v1/tools/grafana.md
- Add InfluxDB version detector shortcode to all Grafana pages
- Add comprehensive alt_links to v2 and Cloud Grafana pages
- Include links to all InfluxDB versions (v1, enterprise_v1, v2, cloud, and all v3 products)
- Improve cross-product navigation for Grafana documentation
- Change pre-release placeholder to official v1.12.2 release
- Remove pre-release warning and TODO comments
- Update patch version in products.yml from 1.11.8 to 1.12.2
- Release date: 2025-09-15
- Restructure content flow to follow progressive disclosure principles
- Move index type decision to Important callout after basic upgrade steps
- Improve headings with active voice ("Switch index types anytime")
- Enhance callout formatting (Important, Tip, Warning callouts)
- Consolidate Enterprise upgrade information into dedicated section
- Improve information hierarchy and scanability
Changes are primarily formatting and phrasing improvements to enhance
developer experience and follow Google Developer Documentation best practices.
- Make TSI recommendation more actionable by explaining benefits (removes RAM limits, better performance for high-cardinality data)
- Fix "from to" grammar typos in index switching instructions
- Add specific scenarios for when to switch between TSI and inmem index types
- Remove "above" directional language per style guidelines
Source: Verified against InfluxDB v1 documentation via MCP docs verification
- TSI details: https://docs.influxdata.com/influxdb/v1/concepts/tsi-details/
- TSI overview: https://docs.influxdata.com/influxdb/v1/concepts/time-series-index/
**Revert this commit for the v1.12 release**\
- Remove links from release notes to upcoming 1.12.x features
- Add callout to explain that v1.12 isn't yet available
**Keep this commit for the upcoming v1.12 release**
- Label upcoming features as v1.12.0+:
- Update configuration documentation for data nodes
- Update database management documentation
- Update influx_inspect tool documentation
- Update show-shards documentation
- Revert product version references to 1.11.8 in products.yml
The influxdata-archive.key is designed to have a good user experience
during key rotations, but in order to do that, we need to properly
verify the key file's fingerprint and not its sha256sum (since the
primary key's fingerprint won't change with key rotations, but the
sha256sum necessarily will).
Update documentation for this to establish best practice and prepare
users for the upcoming key rotation.
Adjust dockerfiles to use this methodology.
- Adds missing examples for v1-compatible /query
- Fixes curl params in examples
- Removes unsupported async option from examples
- Updates terms for consistency with branding and influxdb3 docs
- Copies the missing POST /query operation from swaggerv1compat to the v2 ref.yml
- Effectively removes the separate v1-compat spec, and adds redirects and tags for v1-compat endpoints in v2/ref.yml
- Updates affected links
Migrates v1 OSS and Enterprise sections from the DockerHub README into new pages in docs-v2.
- Add a new section page for Installing and running with Docker.o
1. Created main Docker installation page (docker.md) with:
- Complete Docker setup instructions for Enterprise clusters
- Environment variable configuration options
- Persistent storage examples
- Network setup guidance
- License key requirements using GitHub note callout syntax
2. Enhanced existing installation pages:
- Added Docker installation sections to both meta and data node installation
pages
- Updated the main installation index to include Docker as an option
3. Created Docker troubleshooting guide (docker-troubleshooting.md) with:
- Common Docker-specific issues and solutions
- Debugging commands and best practices
- Positioned next to the Docker installation guide
4. Added proper cross-references:
- Used related frontmatter to link Docker installation to troubleshooting
- Updated navigation and references throughout
The migration preserves all the essential Docker README content while
integrating it properly into the existing InfluxDB Enterprise v1 documentation
structure, following the project's style guidelines and conventions.
Jason Stirnaman
Scott Anderson
Jameelah Mercer
meelahme
Phil Bracikowski
copilot-swe-agent[bot]
Jason Stirnaman
Scott Anderson
Jamie Strandboge