Skip to content

Conversation

jstirnaman
Copy link
Contributor

@jstirnaman jstirnaman commented Oct 6, 2025

Closes #6406
Closes #6399
Part of influxdata/dar/issues/#545: Instruction to enable HTTP/2 in proxies handling v3 query requests from Grafana (and other tools using FlightSQL)

TODO:

  • Add Grafana screenshot for Core once they add the config option.
  • Redo screenshots (some are fuzzy)

Affected URLs:

https://test2.docs.influxdata.com/enterprise_influxdb/v1/tools/grafana/
https://test2.docs.influxdata.com/influxdb/v1/tools/grafana/
https://test2.docs.influxdata.com/influxdb/cloud/tools/grafana/
https://test2.docs.influxdata.com/influxdb/v2/tools/grafana/
https://test2.docs.influxdata.com/influxdb3/core/visualize-data/grafana/
https://test2.docs.influxdata.com/influxdb3/enterprise/visualize-data/grafana/
https://test2.docs.influxdata.com/influxdb3/cloud-dedicated/visualize-data/grafana/
https://test2.docs.influxdata.com/influxdb3/cloud-serverless/visualize-data/grafana/
https://test2.docs.influxdata.com/influxdb3/clustered/visualize-data/grafana/

https://test2.docs.influxdata.com/influxdb3/cloud-dedicated/query-data/odbc/
https://test2.docs.influxdata.com/influxdb3/cloud-serverless/query-data/odbc/
https://test2.docs.influxdata.com/influxdb3/clustered/query-data/odbc/
https://test2.docs.influxdata.com/influxdb3/core/query-data/odbc/
https://test2.docs.influxdata.com/influxdb3/enterprise/query-data/odbc/

https://test2.docs.influxdata.com/influxdb3/cloud-dedicated/visualize-data/powerbi/
https://test2.docs.influxdata.com/influxdb3/cloud-serverless/visualize-data/powerbi/
https://test2.docs.influxdata.com/influxdb3/clustered/visualize-data/powerbi/
https://test2.docs.influxdata.com/influxdb3/core/visualize-data/powerbi/
https://test2.docs.influxdata.com/influxdb3/enterprise/visualize-data/powerbi/

Also, minor fixes in chronograf guides.

image image

MeelahMe and others added 30 commits September 19, 2025 15:37
…ion' of github.com:influxdata/docs-v2 into 6406-grafana-configuration-outline-and-draft-documentation
…ion' of github.com:influxdata/docs-v2 into 6406-grafana-configuration-outline-and-draft-documentation
Creates an interactive InfluxDB version detector component in TypeScript and a shortcode that generates a button to trigger
the version detector modal.
The shortcode takes a parameter that displays a predefined set of links for results.
- Support URL pattern matching and ping header analysis
- Add questionnaire-based product identification logic
- Adds the shortcode in a note in /influxdb3/core/visualize-data/grafana/
- Set up TypeScript configuration for the project
  - Configure automatic TypeScript compilation in pre-commit hooks
- Add to Grafana documentation pages
- Remove last remnants of old Cypress link checker
- Add Cypress tests, but many are still broken

Co-authored-by: Copilot <[email protected]>

Apply suggestions from code review

Co-authored-by: Scott Anderson <[email protected]>

Update layouts/shortcodes/influxdb-version-detector.html

Co-authored-by: Scott Anderson <[email protected]>

Update assets/js/influxdb-version-detector.ts

Co-authored-by: Scott Anderson <[email protected]>

Update assets/styles/components/_influxdb-version-detector.scss

Co-authored-by: Scott Anderson <[email protected]>

Fixes:
- Fix Hugo template to include product names in detector config
- Change elimination scores from -100 to -1000 for proper filtering
- Add scoring logic for generic "InfluxDB" product (OSS v2.x)
- Exclude generic "InfluxDB" from results (too vague)
- Add comprehensive test scenario checklist to Cypress tests
- Free license now correctly excludes Enterprise, Clustered, Dedicated
- Self-hosted now correctly excludes all Cloud products
- SQL language now correctly excludes v1 and v2 products
- Results now show only specific products (OSS 1.x, OSS 2.x, etc.)
Changes:
- When users answer "I'm not sure" to all questions, show a helpful
message directing them to the reference table instead of showing
a weak ranking with low confidence.
- Detect when all questionnaire answers are "unknown"
- Display custom message explaining lack of information
- Auto-expand reference table for easy product identification
- Hide ranked results when insufficient information provided
- Make product names clickable in the quick reference table to allow
users to quickly navigate to product documentation after identifying
their InfluxDB version.
…ion' of github.com:influxdata/docs-v2 into 6406-grafana-configuration-outline-and-draft-documentation
jstirnaman and others added 16 commits October 3, 2025 15:12
…duct and token naming

- Update Core and Enterprise to use shared v3-process-data/visualize/grafana.md
- Fix product name references to use proper {{% product-name %}} shortcode
- Correct token terminology (admin token, database token) across products
- Add HTTP/2 requirement note for SQL queries through Grafana (uses Flight SQL/gRPC)
- Update Flight client library reference to clarify gRPC and Arrow Flight
- Reorganize Grafana screenshot files to use /influxdb/ directory
- Add Cloud Serverless InfluxQL screenshot
…utline-and-draft-documentation

Grafana configuration screenshot and instructions update
- Add Quick reference tables to all Grafana documentation
- Consolidate shared content for InfluxDB v3 products
- Update configuration steps and screenshots
- Remove duplicate grafana.md from shared/influxdb3-visualize
- Delete outdated product-specific Grafana screenshots
- Add new consolidated screenshot for InfluxDB v2 Cloud Flux config
- Standardize authentication and URL configuration guidance
- Improve consistency across v1, v2, and v3 product documentation
- 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
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
…cific examples

- Add ODBC driver installation and configuration docs
- Add Power BI Desktop custom connector setup docs
- Configure host, port, and token conditionals for all InfluxDB 3 products
- Set frontmatter with proper metadata and related content

The shared content files (content/shared/influxdb3-query-guides/execute-queries/odbc.md
and content/shared/influxdb3-visualize/powerbi.md) contain product-specific conditionals
for server URLs, ports, and tokens. Each product version sources these shared files.

Next steps: Edit the content/shared files to update any remaining product-specific
instructions in the step-by-step procedures if needed. Server, port, and token
conditionals are already configured throughout the documentation.
Updated instructions and notes for using Microsoft Power BI with InfluxDB 3. Removed references to InfluxQL and clarified some phrasing.
…rom docs.influxdata.com

- Add direct download URLs for Arrow Flight SQL ODBC driver and Power BI connector
- Remove references to non-existent downloads page
- Update PowerShell commands to download from docs.influxdata.com/downloads/
- Remove ODBC driver and connector from prerequisites (covered in installation steps)
- Keep Dremio documentation reference for additional driver information
- Maintain Move-Item for connector installation (cleaner than Copy-Item)
- Update link checker config to allow docs.influxdata.com/downloads URLs
@jstirnaman jstirnaman changed the title Update grafana docs New tools: Grafana plugin update, InfluxDB 3 ODBC and PowerBI connectors Oct 6, 2025
- Add styled download buttons for Arrow Flight SQL ODBC driver and Power BI connector
- Use direct URLs to docs.influxdata.com/downloads/ for Windows installer
- Remove ODBC driver and connector from prerequisites (installation covered in steps)
- Add transition text explaining installation steps follow
- Maintain Move-Item for connector installation
- Keep Dremio documentation reference for additional driver information
feat(influxdb3): add ODBC and Power BI documentation with product-spe…
…OS/Linux

- Separate Windows installation into PowerShell and Manual tabs
- Add tabs for Windows vs macOS/Linux in Configure and Troubleshooting sections
- Remove top-level headings inside tabs (tab labels serve this purpose)
- Improve PowerShell code with driver path variable
- Fix whitespace issues in Auth Token field with non-breaking space
- Use active voice throughout instructions
@jstirnaman jstirnaman marked this pull request as ready for review October 7, 2025 00:38
@jstirnaman

This comment was marked as outdated.

- 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 grafana.com and subdomains to exclusion list
- Prevents link checking failures due to bot detection and rate limiting
…enterprise

- Add /influxdb3/<version>/visualize-data/<tool>/ aliases to visualize files
- Ensures backward compatibility across cloud-serverless, cloud-dedicated, and clustered
- Matches URL structure used in core and enterprise versions
- Affects: grafana, superset, and tableau documentation
…nal (don't use whitespace in show-in conditional expression)
@jstirnaman jstirnaman requested a review from garylfowler October 7, 2025 01:32
Copy link
Contributor

@garylfowler garylfowler left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Jason!

@jstirnaman jstirnaman merged commit 819edf7 into master Oct 7, 2025
1 of 2 checks passed
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.

Grafana configuration: Outline and draft documentation
4 participants