Commit Graph

1011 Commits (3606b03e7d68960fc8b4a31d949f648fb7059f71)

Author SHA1 Message Date
Jason Stirnaman d68ea2a933
docs(sql): add FLOAT/REAL type casting and precision info (#6856)
- Add FLOAT and REAL to numeric types table
- Document precision differences (~7 vs ~15 significant digits)
- Add warning about precision loss when casting to FLOAT
- Note PostgreSQL behavior difference

Note: DAR-584 referenced Cloud Dedicated, but this behavior is shared
across all InfluxDB 3 products via DataFusion SQL engine.

Closes DAR-584
2026-02-24 10:05:49 -06:00
Jason Stirnaman 61161cc280
feat(ent3): add experimental badge for --use-pacha-tree (#6857)
* fix(ent3): Add link target and experimental caution for PachaTree option.

* feat(ent3): add experimental badge for --use-pacha-tree

Document the experimental PachaTree storage engine option with a
styled badge and caution callout. Add reusable .badge.experimental
class using the existing caution color palette for light/dark modes.

- Add experimental badge to serve options table and config-options
- Add badge theme variables referencing $article-caution-* colors
- Use custom heading ID to preserve #use-pacha-tree anchor
2026-02-23 14:58:35 -06:00
Copilot ba28e124b1
Add Documentation MCP server pages to chronograf, kapacitor, flux, and explorer (#6833)
* Initial plan

* feat: add Documentation MCP server pages to chronograf, kapacitor, flux, and explorer

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* fix: update MCP page descriptions to include product names

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* fix: resolve product-name shortcode for v1/v0 versioned products

The shortcode previously only checked the second URL path segment to
identify products, which works for InfluxDB 3 (/influxdb3/core/) but
fails for older products where the second segment is a version number
(/chronograf/v1/, /flux/v0/).

Add namespace extraction (first path segment) and conditional logic to
look up products by namespace when the version is v1 or v0. This fixes
empty product names in meta descriptions for Chronograf, Telegraf,
Kapacitor, Flux, and InfluxDB Enterprise v1.

* feat: relocate v2/cloud MCP pages and add alt_links for cross-product navigation

- Move MCP server pages from reference/ to tools/ for InfluxDB v2 and Cloud
- Add alt_links frontmatter to all MCP pages for cross-product navigation
- Use product-name shortcode in descriptions for consistency
- Convert code-placeholders shortcode to fenced code block attributes
- Update shared content to use version-agnostic URLs

* Add multi-assistant installation instructions for documentation MCP server (#6836)

* Initial plan

* feat(mcp): add installation instructions for multiple AI assistants

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* refactor(mcp): replace Cline and Windsurf with GitHub Copilot and OpenCode

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-18 14:20:26 -06:00
Jason Stirnaman b4a0eea0a3
feat: add InfluxDB documentation MCP server integration (#6830)
* chore(deps): update yarn dependencies

Run yarn to update lockfile with latest compatible versions.

* feat: add InfluxDB documentation MCP server integration

- Enable MCP widget in Ask AI (data-mcp-enabled, data-mcp-server-url)
- Restructure mcp-server.md with anchor TOC for database and docs MCP
- Add documentation MCP server page for products without database MCP:
  - cloud-serverless, clustered, v2, cloud (TSM), telegraf
  - Place in Reference section (or telegraf_v1_ref menu)
- Add shared content file for docs-only MCP server
- Add "Connect to documentation MCP" link in format-selector dropdown
- Add related MCP links to all get-started/setup pages

* fix: correct JSON syntax and product-aware MCP docs URL

- Fix JSON syntax errors in Cloud Dedicated config examples (= → :)
- Add missing comma in Docker args array for local server config
- Make format-selector MCP docs URL product-aware using Hugo path detection

* docs: add MCP pages for v1 products, fix menu, add screenshot

- Fix cloud-serverless identify-version menu parent to "Administer InfluxDB Cloud"
- Add MCP server pages for influxdb/v1 and enterprise_influxdb/v1 in Tools menu
- Update format-selector with v1 and enterprise_influxdb/v1 MCP docs paths
- Add MCP tool search screenshot showing search_influxdb_knowledge_sources

* Update content/influxdb3/cloud-serverless/get-started/setup.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update content/telegraf/v1/mcp-server.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-17 20:42:56 -06:00
Jason Stirnaman c97428b600
fix(influxdb3): correct Quix Streams guide for Cloud Dedicated (#6828)
* chore(deps): update yarn dependencies

Run yarn to update lockfile with latest compatible versions.

* fix(influxdb3): correct Quix Streams guide for Cloud Dedicated

Extract downsample-quix content to shared file and fix product-specific
terminology, links, and prerequisites for Cloud Dedicated and Clustered.

- Use "database" terminology for Cloud Dedicated/Clustered
- Remove Docker from prerequisites (not used in guide)
- Add alt_links for cross-product navigation
- Fix broken TOC anchor links
- Add links to admin pages for tokens and databases
- Remove incorrect /reference/regions link for Cloud Dedicated
- Add lint rules for deprecated code-placeholders and py fence

Closes #6825

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* fix(influxdb3): fix broken code blocks in Quix Streams guide

Code blocks inside show-in shortcodes were missing closing fences,
causing the markdown to render incorrectly. Added proper fence
boundaries and placeholder key documentation for each code section.

Also adds TODO to content-editing skill about improving automation
for code-placeholder-key workflow.

* Docs v2 docs v2 pr6828 (#6829)

* fix(influxdb): Rename to match other pages. Remove alt_links

* chore(deps): bump ESLint to 10.0.0

* Update content/shared/v3-process-data/downsample/quix.md

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-02-17 15:23:16 -06:00
Muhammed Hussain Karimi d48c545531
Correct AWS_ACCESSKEY_ID to AWS_ACCESS_KEY_ID (#6824) 2026-02-15 17:41:28 -06:00
Copilot 57ad83ba1c
Mark disabled field as required in processing engine trigger API specs (#6790)
* fix(influxdb3): Mark disabled field as required in processing engine trigger API specs

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Add HTTP API examples to Processing Engine plugin documentation (#6789)

- Add disabled field and api-ref to API examples per review feedback
- Add api-ref to upload plugin endpoint and remove duplicate link sentence
- Convert {{% code-placeholders %}} shortcode to placeholders code block
  attribute for cleaner syntax
- Add second argument to token-link shortcodes for admin tokens to
  ensure consistent linking to /admin/tokens/admin/ path
- Follows PR 6789 review feedback for processing engine documentation

fix(influxdb3): update placeholder and token-link syntax in get-started

- Convert code-placeholders wrapper shortcodes to code block attributes

* fix(influxdb3): Fix broken trigger anchor links in plugin documentation

Rename "Set up a trigger" heading to "Create a trigger" and update
all internal anchor references to match.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-09 15:46:37 -06:00
github-actions[bot] 0c2f9e8dbc
fix(plugins): porting README details to docs (#6806)
- Handle multi-line emoji metadata ( on line 1, 🔧 on line 2)

    Content updates:
    - Remove residual emoji metadata from 5 plugins
    - Clarify HTTP request body parameters in notifier plugin
    - Update CLI examples (--plugin-filename → --path) from source
    - Preserve "InfluxDB 3 Explorer" product name
    - Fix "Pandas" → "pandas" capitalization

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-09 14:55:23 -06:00
Jason Stirnaman 322b77e280
docs(influxdb3): document trigger logging behavior (#6804)
* docs(influxdb3): document trigger logging behavior

Add processing_engine_logs table documentation to system data reference,
explaining that logs are stored in both the trigger's database (primary)
and _internal. Update plugins error handling to specify trigger's database.

* Update content/shared/influxdb3-plugins/_index.md
2026-02-09 14:32:44 -06:00
Copilot 5b89c38b9f
Fix SQL date part identifier: day → doy (day of the year) (#6791)
* Initial plan

* Fix typo: day -> doy (day of the year)

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
2026-02-04 08:29:18 -06:00
github-actions[bot] 30637d8ae8
Sync plugin documentation: basic_transformation, downsampler (#6784)
* sync: update plugin documentation from influxdb3_plugins@main

Plugins: basic_transformation, downsampler

* Apply suggestions from code review

---------

Co-authored-by: jstirnaman <jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-02-02 15:13:57 -06:00
Jason Stirnaman 3933872921
docs(influxdb3): Add Docker Compose and CI/CD examples for preconfigured (#6777)
tokens
2026-01-30 13:28:11 -06:00
Jason Stirnaman 348bc5ae17
hotfix(influxdb3): Use "Enterprise" instead of shortcode in shared (#6769)
content
2026-01-27 15:22:38 -06:00
Jason Stirnaman c32e05175d
docs(influxdb3): Add Core to Enterprise upgrade documentation (#6758)
Add dedicated documentation for upgrading from InfluxDB 3 Core to
Enterprise, covering Quick install, Docker, and DEB/RPM workflows.

- Create shared upgrade-to-enterprise.md with step-by-step instructions
- Add frontmatter pages for Core (/admin/upgrade-to-enterprise/) and
  Enterprise (/admin/upgrade-from-core/) with alt_links
- Expand license.md with license tier management procedures
- Add upgrade cross-references to install pages
- Rename upgrade.md titles for SEO clarity (Upgrade InfluxDB 3 Core/Enterprise)

Closes influxdata/DAR#596
2026-01-27 12:16:48 -06:00
Jason Stirnaman 68f00e6805
fix(version-detector): centralize Grafana links and DRY up host examples (#6693)
* fix(version-detector): use centralized getGrafanaLink for all Grafana URLs

Refactor handleAuthorizationHelp to use getGrafanaLink() instead of
hardcoded URLs, ensuring all Grafana links come from a single source.

Also fix incorrect URLs in getGrafanaLink mapping:
- InfluxDB OSS 2.x: /visualize-data/ → /tools/
- InfluxDB Enterprise: /influxdb/enterprise/ → /enterprise_influxdb/v1/
- InfluxDB Cloud (TSM): /visualize-data/ → /tools/
- InfluxDB Cloud v1: now links to Enterprise v1 docs (Cloud v1 is
  Enterprise under the hood)

* refactor(version-detector): DRY up localhost:8086 references

Extract HOST_EXAMPLES to a class-level constant and add DEFAULT_HOST
and DEFAULT_HOST_PORT constants to eliminate duplicate localhost:8086
strings throughout the code.

- Move hostExamples from local variable to class constant
- Use DEFAULT_HOST for URL placeholder and comparison checks
- Use DEFAULT_HOST_PORT for docker curl command examples

* feat(ask-ai): Support source group IDs in Ask AI trigger links

* feat(version-detector): Present context-aware links

- Add ai_source_group_ids fields to ProductConfig interface
- Improve SCSS for doc and Ask AI links
- Update Grafana docs to add aliases and context param for detector
- Update modal partial to include AI source group IDs in config
- Remove custom Cypress commands for version detector
- Update E2E tests to use direct Cypress commands
2026-01-26 18:42:09 -06:00
Jason Stirnaman fc8c9bbe29
Revise release notes for InfluxDB 3 catalog path structure (#6738)
* Revise release notes for InfluxDB 3 catalog path structure

Updated release notes to reflect operational and security improvements, including changes to catalog path structure and log verbosity.

* Clarify file vs directory distinction in catalog v2 path structure (#6740)

* Initial plan

* Clarify that snapshot is a file and logs is a directory

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2026-01-26 14:10:47 -06:00
Jason Stirnaman e4f9d440e3
docs(influxdb3): Use a GET request to check ping response headers. (#6749)
- Updates identify-version guide and Core/Ent3 API specs
- Use GET. HEAD `/ping` responds with `404`
- Specify default auth requirement for Enterprise
- Tested with Core and Ent v3.8.0
2026-01-16 20:51:49 -06:00
Jason Stirnaman a5f846b544
Dar 589 cli api params (#6719)
* docs(influxdb3): fix format in GET /api/v3/configure/database

* docs(influxdb3): `fields` is required for `influxdb3 tables create` and
API
2026-01-15 15:51:16 -06:00
Andre Guerra 5756dba6a3
replace catalogs for catalog as observed in a live core db data files (#6712)
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2026-01-15 15:30:52 -06:00
Jason Stirnaman 1590d4e2d6
fix(influxdb3): `api/v3/configure/database` requires format (#6714)
* fix(influxdb3): `api/v3/configure/database` requires format

Closes influxdata/dar/580

- `format` query param is required
- Provide examples, including parquet to output file

influxdb3 CLI doesn't support `--output` for parquet.

* Update content/shared/influxdb3-admin/databases/list.md

* Add influxdb3 query parquet output example (#6735)

* Initial plan

* Add uncommented parquet output example using influxdb3 query

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Use --database instead of --db for consistency

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Move parquet output section to CLI section and revise intro

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Update content/shared/influxdb3-admin/databases/list.md

* Update content/shared/influxdb3-admin/databases/list.md

* Simplify parquet intro and reorder HTTP API response description

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Update content/shared/influxdb3-admin/databases/list.md

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2026-01-15 15:07:22 -06:00
Jason Stirnaman 42ae0fbf6b
dar issue 563 - Cloud 1 documentation, support, and migration (#6729)
* docs(v2): Specify versions for v2 Cloud and OSS

* docs(v2): Use specific version for OSS v2, add ToC

* docs(v1): Use specific versions and names. Replace Enterprise v1 with 3
Ent.

* docs(v1): More detailed description for OSS v1 release notes. Repetition
fixes.

* docs(v1): Update Download instructions. Add version specificity

* docs(v1): OSS v1 specificity, fix config commands, cleanup lists

* docs(cloud1): Shared note shortcode to guide Cloud 1 users to Enterprise
documentation, Cloud 1 support, and v3 migration

* Provide Cloud 1.x in version detector and product selector menu,
simplify InfluxDB 1.x section

- Simplify InfluxDB 1.x section on platform page to product links and
  migration guidance
- Remove detailed TICK stack and Enterprise feature descriptions
- Update all Cloud 1 links to point to /platform/#influxdb-cloud-1

- Keep Cloud 1 infrastructure intact:
  - products.yml configuration
  - Product selector entry (links to platform page section)
  - Version detector for *.influxcloud.net service URLs
  - Ask AI integration

Files changed:
- content/platform/_index.md (simplified, updated links)
- content/shared/identify-version.md (updated links)
- layouts/shortcodes/influxdb-cloud1-note.html (updated links)
- assets/js/utils/product-mappings.ts
- assets/js/influxdb-version-detector.ts

Closes /influxdata/dar/issues/563

* Delete content/influxcloud/v1/_index.md

* Update content/enterprise_influxdb/v1/_index.md

* Update content/influxdb/v1/introduction/install.md

* Fix PR Preview skipping when layout changes include wildcard URL patterns (#6725)

* Initial plan

* Fix: Strip wildcards from URL paths in PR Preview detection

- Update normalizeUrlPath() to remove asterisk wildcards
- Collapse multiple consecutive slashes after wildcard removal
- Add backtick as valid URL delimiter for code-wrapped URLs
- Add comprehensive test cases for wildcard handling
- Update backtick test to reflect safer truncation behavior

Fixes issue where PR descriptions with wildcard patterns like
`/influxdb3/enterprise/*` were not properly extracted, causing
PR Preview to skip even when URLs were provided.

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* docs: Clarify backtick handling in URL validation

Add comment explaining that backticks act as delimiters in regex
extraction, preventing them from appearing in extracted paths even
though they're in the rejection pattern.

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* docs: Improve comments explaining normalization and regex logic

- Clarify why wildcards are removed before slash collapsing
- Document the defense-in-depth backtick handling
- Add examples of the normalization process

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Update content/platform/_index.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* refactor: organize cloud1-note shortcode into influxdb directory (#6734)

Move the Cloud 1 note shortcode from influxdb-cloud1-note.html
to influxdb/cloud1-note.html to follow the existing organizational
pattern in layouts/shortcodes/influxdb/.

This change also applies the Cloud 1 content updates from PR #6729
using the new organized shortcode path: {{< influxdb/cloud1-note >}}

closes influxdata/docs-v2#6729

Co-authored-by: Claude <noreply@anthropic.com>

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
2026-01-15 14:55:06 -06:00
Daniel Campbell fafc37543a
docs(chronograf): add instructions for use with InfluxDB3 products (#6730)
* docs(chronograf): add instructions for use with InfluxDB3 products

* docs(chronograf): add images and update text

* Claude/review pr 6730 pd m hs (#6732)

* fix(chronograf): address review feedback in PR #6730

- Reorganize InfluxDB connection options with nested structure
- Add expand-wrapper for optional management and database fields
- Format placeholders in CLI examples using docs placeholders command

Addresses @claude tasks in review comments:
- Comment 2688897045: Reorganize content sections
- Comment 2688946374: Wrap optional fields in expand-wrapper
- Comments 2688955219, 2688955604: Format placeholders

* fix(influxdb3): format placeholders in remaining chronograf CLI examples

Add placeholder syntax to CLI configuration examples across all InfluxDB 3 products:
- Cloud Serverless: API_TOKEN, BUCKET_NAME
- Clustered: DATABASE_NAME, DATABASE_TOKEN, MANAGEMENT_TOKEN
- Core: DATABASE_TOKEN
- Enterprise: DATABASE_NAME, DATABASE_TOKEN

Addresses @claude tasks in review comments:
- Comment 2688983661: cloud-serverless placeholders
- Comment 2688990379: clustered placeholders
- Comment 2688998186: core placeholders
- Enterprise file (not in review but follows same pattern)

---------

Co-authored-by: Claude <noreply@anthropic.com>

* Replace inline img tags with img-hd shortcode in Chronograf docs (#6731)

* Initial plan

* docs(chronograf): replace img tags with img-hd shortcode

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* docs(influxdb3): improve Chronograf prerequisites and add placeholder descriptions

- Replace 'running and accessible' with clearer prerequisite structure
- Add structured prerequisites matching cloud variants' pattern
- Add 'Replace the following' sections with placeholder descriptions
- Use token-link shortcode for consistent token references across products
- Fix code-placeholder-key shortcode usage

* fix(influxdb3): correct database token link paths in Chronograf placeholder descriptions

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
2026-01-15 13:24:09 -06:00
Jason Stirnaman bd6f7481b0
Dar 588 plugins (#6718)
* fix(influxdb3): source comments

* docs(influxdb3): fix plugin path handling and improve Get Started clarity

Fixes issues with plugin filename resolution and improves progressive
disclosure in the processing engine Get Started guide.

- Update `--plugin` flag to `--path` (current CLI syntax)
- Clarify plugin filename must be provided without relative/absolute paths
- Add note explaining path resolution relative to `--plugin-dir`
- Document single-file vs multi-file plugin path requirements
- Link to detailed multi-file plugin structure documentation

- Add "Before you begin" section listing required setup steps
- Add prerequisites to table of contents
- Improve progressive disclosure by front-loading essentials

- Update trigger type from "Data write" to "WAL rows" (consistent with `influxdb3 create trigger --help`) with WAL link
- Replace `--plugin` with `--path` in trigger creation example
- Fix syntax error in enable trigger example (missing backslash)
- Clarify plugin example as "data write (WAL) plugin"
- Update code comments for clarity and remove outdated notes
- Specify "wal_rows trigger specification" terminology

- Specify testing "process_writes (WAL) plugin" for clarity
- Reference multiple test commands, not just wal_plugin
- Add link to schedule_plugin test command
- Clarify that PLUGIN_FILENAME should be filename only

- Prevents path resolution errors users encountered
- Aligns documentation with current CLI behavior
- Improves Get Started guide readability and flow
- Reduces confusion about plugin file handling

Closes #588

* docs(influxdb3): Docker Compose optional plugin directory
- Added inline comments to Docker Compose examples: `# Optional: only
  needed for processing engine plugins`
- Appears for both `--plugin-dir` flag and volume mount
- Helps users understand they can skip this if not using plugins
- Better progressive disclosure - users see it's optional without
  needing separate explanation

* docs(influxdb3): Replace --plugin-filename with --path
- Uses `--path` for plugins, replacing deprecated `--plugin-filename`
- Replaces "Data write" with "WAL rows" to be consistent with CLI help
  docs

* Update content/shared/influxdb3-get-started/processing-engine.md

* fix(deps): add missing yarn.lock updates for puppeteer

The puppeteer dependency was added to package.json in commit 784956a31
but yarn.lock was not updated, causing CI failures with --frozen-lockfile.

* chore(deps): upgrade puppeteer to 24.35.0

- Upgrade puppeteer from 23.11.1 to 24.35.0
- Fix deprecated page.waitForTimeout() - replaced with Promise/setTimeout
- Fix deprecated headless: 'new' - now just uses headless boolean

The 'new' headless mode is now the default in Puppeteer 24.
2026-01-14 18:17:14 -06:00
Jamie Strandboge f84c152929
fix: /etc/influxdb3 is root:influxdb3 (#6720) 2026-01-12 10:44:59 -06:00
Jason Stirnaman b093b104b8
fix(influxdb3): server flags and defaults in Enterprise setup (#6716)
Closes influxdata/dar/issues/587
- Wrong flag name corrected
- Added `--aws-default-region` flag with explanatory note
- Added `--plugin-dir` requirement documentation for process
2026-01-09 15:45:54 -06:00
Jason Stirnaman 1203602607
docs(influxdb3): document log-filter values and targeted filtering (#6695)
* chore(link-checker): update configs for v1.3.0 severity classification

Remove exclusions for sites that return 403/429 (bot protection) and
5xx (server errors) - these are now handled by severity classification:
- 403/401/429 → info (shown but don't fail CI)
- 5xx/timeout → warning (shown but don't fail CI)
- 404/410/DNS → error (fail CI)

Removed exclusions:
- GitHub, Slack, Reddit, StackOverflow
- Docker Hub, Grafana, Microsoft Learn
- Claude.ai, Dremio, Scarf, InfluxData support

Kept exclusions:
- Localhost/local network URLs
- Example/placeholder URLs
- CI-specific workarounds (canonical URLs, file fragments)

Added [severity] configuration section with default thresholds.

* docs(influxdb3): document log-filter values and targeted filtering

Add comprehensive documentation for the --log-filter configuration option:
- Log levels table (error, warn, info, debug, trace)
- Targeted filtering syntax for specific components
- Common component names for Core and Enterprise
- Debug logging section in write troubleshoot page

closes influxdata/DAR#575

* Update content/shared/influxdb3-cli/config-options.md
2026-01-06 14:01:49 -06:00
Jason Stirnaman 4ddce8a57e
docs: add CLAUDE.md files for generated content directories (#6690)
Add guidance for AI tools about generated documentation:
- content/shared/influxdb3-plugins/plugins-library/official/CLAUDE.md
- content/telegraf/CLAUDE.md

These files document the sync workflows and prevent AI tools from
editing generated content directly.
2026-01-02 16:25:31 -06:00
Jason Stirnaman b8418d9788
fix(shortcodes): latest-patch CLI version for cloud-serverless (#6655)
* fix(shortcodes): latest-patch CLI version for cloud-serverless

Add cloud-serverless to the condition that handles cloud products,
and use influxdb.latest directly for CLI version lookups.

Root cause: The shortcode only checked for "cloud" version when
deciding to use the influxdb CLI version. Cloud Serverless pages
have $product="influxdb3" which doesn't exist in products.yml,
causing $latestVersion to be empty.

Fix: Calculate $influxdbLatest directly from products.influxdb.latest
within the CLI block, ensuring cloud products always use the correct
lookup key (v2) for the influx CLI version.

Includes Cypress test covering v2, Cloud, and Cloud Serverless.

Closes #6646

* Restore latest-patch shortcode for cloud-serverless. Revert "hotfix: influxdb (v2) CLI version (#6644)"

This reverts commit 5f792bd47a.

* chore(link-checker): update configs for v1.3.0 severity classification (#6688)

Remove exclusions for sites that return 403/429 (bot protection) and
5xx (server errors) - these are now handled by severity classification:
- 403/401/429 → info (shown but don't fail CI)
- 5xx/timeout → warning (shown but don't fail CI)
- 404/410/DNS → error (fail CI)

Removed exclusions:
- GitHub, Slack, Reddit, StackOverflow
- Docker Hub, Grafana, Microsoft Learn
- Claude.ai, Dremio, Scarf, InfluxData support

Kept exclusions:
- Localhost/local network URLs
- Example/placeholder URLs
- CI-specific workarounds (canonical URLs, file fragments)

Added [severity] configuration section with default thresholds.
2026-01-02 12:47:12 -06:00
Jason Stirnaman 7ed3861031
fix(influxdb3): publish parameterized queries and add HTTP API examples (#6673)
- Fix broken link to parameterized queries in time-and-timezone.md
- Remove draft: true from Core and Enterprise InfluxQL parameterized queries
- Add HTTP API examples for Core/Enterprise using /api/v3/query_sql and
  /api/v3/query_influxql endpoints
- Simplify list_code_example frontmatter to use query-only format across
  all SQL and InfluxQL parameterized queries pages
- Fix api-endpoint shortcode arguments to use correct method, endpoint,
  and api-ref parameters

Note: PR preview URLs show broken /version/ links but they render
correctly in local Hugo testing. The link replacement logic in
layouts/partials/article/content.html processes these correctly.

Closes #6672
2025-12-27 15:01:20 -06:00
Jason Stirnaman 44081e7eb9
Merge branch 'master' into jdstrand/fix-rpm-install2 2025-12-23 11:06:51 -05:00
Jamie Strandboge 47ca3066c3
fix: use sudo with 'yum install' and create the keyring dir if needed 2025-12-23 09:38:38 -06:00
Jason Stirnaman 2ab200d78b
influxdb3: Add Helm for Ent3, cleanup install.md formatting (#6657)
* docs(influxdb3): add Helm chart deployment guide for Enterprise

Add documentation for deploying InfluxDB 3 Enterprise on Kubernetes
using the official Helm chart (currently in beta). The guide covers:

- Prerequisites and licensing information
- Installation steps using Helm
- Configuration options for object storage (S3, Azure, GCS, MinIO)
- Cluster and ingress configuration
- Upgrade and uninstall procedures
- Troubleshooting commands
- Support and issue reporting links

* chore(influxdb3): Cleanup install

* chore(influxdb3): add version metadata for systemd
2025-12-22 16:52:31 -06:00
Copilot 77e52a54b9
Move influxctl --perf-debug example output to command reference (#6599)
* Initial plan

* docs: move perf-debug example output to query command reference

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* docs: update placeholder syntax and add link to query command

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* docs: add disclaimer for example performance statistics output

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* fix(influxdb3): update --perf-debug example output to match documented query

Regenerate example performance statistics output using the documented
query (SELECT SUM(temp) FROM home). Tested influxctl query --perf-debug
command to verify output format and values.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-12-22 13:11:35 -06:00
Jamie Strandboge c1a0785612
fix: move 'yum install' outside the 'cat' for influxdb3 installs (#6666) 2025-12-22 12:26:18 -06:00
Jamie Strandboge 56bdda83aa
fix: add a few missing DEB/RPM instructions for license activation; shell source is for quick install (#6652)
* fix: add a few missing DEB/RPM instructions for license activation

* fix: sourcing shell config only needed with quick installs

* chore: address review feedback from Jason
2025-12-18 17:05:34 -06:00
Jamie Strandboge 50397f2dc4
chore: update install and license info for DEB/RPM (#6650)
* fix: remove a couple of mis-merges and clarify DEB/RPM is non-Docker

* chore: update install and license info for DEB/RPM

* chore: incorporate formatting and style feedback from Jason

* fix(influxdb3): Install: ToC and merge cleanup

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-12-18 15:24:40 -06:00
Jason Stirnaman b2efc05a87
influxdb3 security cleanup (#6649)
* hotfix(influxdb3): fix duplicate menu entry for Enterprise security page

Change menu key from influxdb3_core to influxdb3_enterprise.

* chore(influxdb3) Security: style and cleanup: intro, requirements, callouts
2025-12-18 11:19:09 -06:00
Jason Stirnaman 2f5af3c54c
docs(influxdb3): release documentation for Core and Enterprise v3.8.0 (#6647)
* docs(influxdb3): release documentation for Core and Enterprise v3.8.0

- Update latest_patch to 3.8.0 in products.yml
- Add placeholder release notes for v3.8.0
- Update site notification for v3.8.0 release

* chore: add 3.8 release notes (#6638)

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* feat(influxdb3): update install for DEB/RPM and add admin/security (#6643)

* feat(influxdb3): add shared/influxdb3-admin/security.md

* feat(influxdb3): update install for DEB/RPM

* chore: fix hard-coded 'enterprise' in influxdb3 install

* Update content/shared/influxdb3/install.md

Love it!

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Update content/shared/influxdb3/install.md

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Update content/shared/influxdb3/install.md

* Update content/shared/influxdb3/install.md

* Update content/shared/influxdb3/install.md

* Update content/shared/influxdb3/install.md

* Update content/shared/influxdb3/install.md

---------

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

* Update content/shared/influxdb3/install.md

* chore: add influxdb 3.8 notification (#6645)

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>

---------

Co-authored-by: peterbarnett03 <peter.barnett03@gmail.com>
Co-authored-by: Jamie Strandboge <jamie@influxdata.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-12-18 09:54:25 -06:00
Jason Stirnaman 5f792bd47a
hotfix: influxdb (v2) CLI version (#6644)
- latest-patch shortcode doesn't work in cloud-serverless code samples
- reverted to hardcoded CLI version in shared file and Serverless-specific file
2025-12-17 15:13:02 -07:00
Jason Stirnaman 0856e60e55
Fix link checker for fragments (#6626)
* Apply suggestions from code review
Apply to cloud-serverless

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* fix(influxdb3): broken links and aliases:

The link in the cloud-serverless schema-design page was pointing to /influxdb3/cloud-serverless/reference/line-protocol/#duplicate-points, but the actual file is located at /influxdb3/cloud-serverless/reference/syntax/line-protocol/
Core/Ent3 aliases were missing trailing slash, preventing navigating directly from other product line protocol docs

* chore: cleanup

* fix(ci): skip fragment validation for local file URLs in link-checker

Workaround for link-checker Hugo pretty URL bug where /path/to/page#fragment
is converted to file:///path/to/page#fragment instead of
file:///path/to/page/index.html#fragment.

All 60 'broken' fragments reported by CI actually exist in the HTML files.

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-12-15 09:24:43 -06:00
Jason Stirnaman b9e4035aea
docs(influxdb3): document duplicate point write ordering and workarounds (#6584)
* docs(influxdb3): document duplicate point write ordering and workarounds

Expand duplicate points documentation for Cloud Dedicated and Clustered
to address non-deterministic write ordering when duplicate points are
flushed together.

Changes:
- Add warning callout explaining duplicate point overwrites are non-deterministic
- Add recommended patterns section with append-only approaches
- Add SQL and InfluxQL query examples for getting latest state
- Add anti-patterns section with common mistakes to avoid
- Add retention guidance for last-value tables (Cloud Dedicated only)
- Add performance considerations for append-only patterns
- Add cross-links from schema-design and optimize-writes pages

closes influxdata/DAR#560

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

* Apply suggestion from @jstirnaman

* fix(influxdb3): broken links and aliases:

The link in the cloud-serverless schema-design page was pointing to /influxdb3/cloud-serverless/reference/line-protocol/#duplicate-points, but the actual file is located at /influxdb3/cloud-serverless/reference/syntax/line-protocol/
Core/Ent3 aliases were missing trailing slash, preventing navigating directly from other product line protocol docs

* chore: cleanup

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-12-12 17:02:14 -06:00
Dustin Eaton df6aa0abc0 chore: remove extra code block syntax from influxctl release notes 2025-12-11 13:17:08 -06:00
peterbarnett03 3ffab3afa1
Rename telemetry-disable-upload to disable-telemetry-upload (#6594)
Fixes a CLI incorrect command

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-12-10 10:16:40 -06:00
Jason Stirnaman 44ad61d651
Update content/shared/influxctl/release-notes.md
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-12-09 10:41:03 -06:00
Dustin Eaton d690edb645 chore(influxctl): add influxctl 2.12.0 release notes 2025-12-09 10:35:11 -06:00
Copilot db9a727789
Add Windows environment variable instructions for INFLUXDB3_AUTH_TOKEN (#6325)
* Initial plan

* feat: add Windows environment variable instructions for INFLUXDB3_AUTH_TOKEN

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* refactor: update to new code-placeholders syntax

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Separate env var and CLI option into distinct sections instead of nested tabs

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* Clarify that both auth methods are for CLI commands with parallel headings

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

* fix(3ent/core): Set token env var in Windows, clean up structure

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-12-02 16:39:12 -06:00
Scott Anderson 6b1905c1d5
fix: updates write reponses, suggests exponential backoffs (#6574)
* fix: updates write reponses, suggests exponential backoffs, closes influxdata/DAR#557

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Fix cURL example to use $max_delay variable instead of hardcoded value (#6575)

* Initial plan

* Fix: use $max_delay variable instead of hardcoded 30 in cURL example

Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jstirnaman <212227+jstirnaman@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-12-02 11:40:56 -08:00
Jason Stirnaman b95e608d07
docs(influxdb3): Use the CLI (influxdb3 --version), /ping endpoint, or /health endpoint to get the actual InfluxDB product version—not the SQL version() function. (#6579)
Summary of Changes

  1. content/shared/sql-reference/functions/misc.md (SQL version() function)

  - Enhanced the description to clarify it returns the DataFusion query engine version
  - Added a Note callout explicitly stating this is NOT the InfluxDB product version
  - Added a link to the identify-version page for users who want to find their InfluxDB version
  - Added an expandable example with the actual query and output:
  SELECT version()
  - Output: Apache DataFusion 49.0.2, aarch64 on linux

  2. content/shared/identify-version.md (Identify version page)

  Added a Note callout in three locations:
  - Core-specific section (show-in "core")
  - Enterprise-specific section (show-in "enterprise")
  - General InfluxDB 3 Core and Enterprise section (in the tabs)

  Replaced hardcoded patch version with latest-version shortcode
2025-12-01 16:02:25 -06:00
Jason Stirnaman ec70614a4e
docs(sql): add LAG examples for time-based value comparisons (#6577)
* chore(sql): add LAG examples for time-based value comparisons

Enhance window function documentation with practical examples for
calculating differences between current and previous values (e.g., 1h ago).

- Add 3 LAG examples to window functions reference with tested queries
- Create new 'Compare values' query guide covering common time-based
  comparison patterns (differences, percentage changes, exact intervals)
- Add guide frontmatter for all InfluxDB 3 products

All queries validated against InfluxDB 3 Core.

Refs: Kapa.ai conversation https://app.kapa.ai/720100f9-ce93-4305-88fd-5fcf71effad7/conversations/4536b79e-3930-4359-87f5-2ad9ccc1917d
Starting from: https://docs.influxdata.com/influxdb3/cloud-serverless/reference/sql/functions/window/

* chore(sql): add counter metrics examples to compare-values guide

Enhance time-based value comparisons with counter metrics patterns
using LAG and GREATEST to handle counter resets.

- Add counter metrics section with 3 examples (rate, cumulative, intervals)
- Include tested queries for non-negative differences and aggregation
- Document workarounds for Flux increase() and InfluxQL NON_NEGATIVE_DIFFERENCE()

All queries validated against InfluxDB 3 Core.

Refs: Kapa.ai conversation https://app.kapa.ai/720100f9-ce93-4305-88fd-5fcf71effad7/conversations/16b13679-0ced-4780-ab58-3d9cacb2d899
Starting from: https://docs.influxdata.com/influxdb3/enterprise/

* Update content/shared/influxdb3-query-guides/sql/compare-values.md

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-12-01 15:14:44 -06:00
Jason Stirnaman 0fcf2bdd31
Note excluded internal-use options (#6571)
* chore: Standard exclude comment format to denote flags, options, etc. that shouldn't be promoted in docs

* chore: exclude internal flags

* chore: Add docs:exclude comments for internal CLI flags, fix linting

- Note internal options that should be ignored by `docs audit` and authors.
- Remove character escaping from GitHub callouts and placeholders

Lint config changes:
- Add explicit exclude for content/**/*.md in lint-markdown-instructions
- Exclude all markdown files from Prettier formatting

Fixes issue where remark-lint was auto-formatting content files and
escaping special characters like [!Note] callouts and underscores.

* fix: cleanup escaping
2025-11-25 16:58:29 -06:00