Commit Graph

95 Commits (jts-dar-514-clustered-query-troubleshooting)

Author SHA1 Message Date
Jason Stirnaman 8f42f9ffa2
Merge branch 'master' into jts-dar-514-clustered-query-troubleshooting 2025-08-19 08:31:52 -05:00
Jason Stirnaman ddb9a5584d fix(clustered): clarify compactor scaling guidance for CPU and memory
Addresses customer confusion where scaling CPU alone doesn't improve
compactor performance. Compactor concurrency scales based on memory
allocation, not CPU count, so both resources should be scaled together.

Closes influxdata/DAR#514

add related links

fix(clustered): correct anchor link in scale-cluster documentation

Fix broken internal anchor link from #rrecommended-scaling-strategies-per-component
to #recommended-scaling-strategies-per-component (removed extra 'r').

This was used to test the improved link-checker anchor validation functionality.

fix(clustered): correct anchor link in scale-cluster documentation

Fixes broken anchor link #rrecommended-scaling-strategies-per-component
to the correct #recommended-scaling-strategies-per-component
2025-08-18 18:02:37 -05:00
Jason Stirnaman 11af1444ef
Update content/influxdb3/clustered/query-data/troubleshoot-and-optimize/report-query-performance-issues.md 2025-08-13 14:28:17 -05:00
Jason Stirnaman 429e413c2e
Update content/influxdb3/clustered/query-data/troubleshoot-and-optimize/report-query-performance-issues.md 2025-08-13 14:27:30 -05:00
Jason Stirnaman 96fdb3ea0b
Update content/influxdb3/clustered/query-data/troubleshoot-and-optimize/report-query-performance-issues.md 2025-08-13 14:26:30 -05:00
Jason Stirnaman a81e9d10a7 feat(clustered): add dashboard screenshot guidance for query performance issues
Adds specific IOx Querier dashboard metrics to capture when reporting
query performance issues to InfluxData engineers, including:
- CPU utilization and resource limits
- Object Store Traffic/Latency metrics
- Cache Requests and miss rates
- Query concurrency and rate metrics
- Parquet files per query counts
- Request Duration timing

Also includes sample EXPLAIN ANALYZE output to help users focus on
the most critical performance bottleneck indicators.

Addresses secondary issue in influxdata/DAR#514
2025-08-13 14:21:12 -05:00
Jason Stirnaman a7e8fe8625 fix(influxdb3): address Reid's review feedback on query timeout best practices
Address reidkaufmann's review comments on query timeout documentation:

Technical accuracy fixes:
- Replace "node/nodes" terminology with "querier/queriers" throughout
- Remove AI hallucination: "query result caching" (doesn't exist in IOx)
- Replace with proper cache recommendations for Enterprise/Core users
- Remove vague "background maintenance" references
- Add specific compaction performance variation cause
- Fix "round-robin or load-balanced" → "round-robin query routing"

Content improvements:
- Enhance checkout line analogy with explanation of noisy neighbors
- Add experimental query guidance for reducing impact on other users
- Replace unactionable solutions with customer-controllable actions
- Restore missing flexibility recommendations and link to the code sample

Technical updates:
- Update code blocks to use new placeholder syntax
- Add related links between cache documentation and timeout strategies
- Fix numbering consistency in Solutions sections
2025-08-12 16:10:28 -05:00
Jason Stirnaman af06fd8743
Merge branch 'master' into jts-dar-526-clustered-timeouts 2025-08-12 12:57:11 -05:00
Jason Stirnaman c362792f3f feat(influxdb3): add 'partial writes' tag to distributed troubleshooting pages
Add 'partial writes' tag to frontmatter for better content discoverability:
- content/influxdb3/cloud-dedicated/write-data/troubleshoot.md
- content/influxdb3/cloud-serverless/write-data/troubleshoot.md
- content/influxdb3/clustered/write-data/troubleshoot.md

This helps users find information about partial write scenarios across InfluxDB 3 distributed editions.
2025-08-11 15:55:58 -05:00
Jason Stirnaman eb3dc0b0ff improve and enhance write data troubleshooting for influxdb3 distributed
- Update clustered, cloud-dedicated, and cloud-serverless to share enhanced troubleshooting content
- Add comprehensive error capturing instructions with curl examples
- Include client library debug logging samples (Python, Go, Java, JavaScript)
- Provide detailed guidelines for reporting persistent write issues to support
- Split HTTP status code tables by product type for clarity

This standardizes troubleshooting across all InfluxDB 3 distributed editions.

Closes influxdata/DAR#522
2025-08-11 15:51:10 -05:00
Jason Stirnaman e506402aa1 chore(influxdb3-distrib): Recommend best practices for adjusting client timeouts when querying InfluxDB 3 distributed.
- Closes influxdata/dar#526
- Adds Python client examples
- Adds influxctl examples

Co-authored-by: Reid Kaufmann
2025-08-11 12:11:20 -05:00
Jason Stirnaman a38dd87629 Update content/influxdb3/clustered/reference/release-notes/clustered.md 2025-08-05 09:22:01 -05:00
Dustin Eaton ee20564750 Clustered release 20250721-1796368 2025-08-05 09:22:01 -05:00
Joel Abshier 5bb4f14f39
Release influxctl v2.10.3 (#6270)
* Release influxctl v2.10.3

* add influxctl 2.10.3 release notes and feature docs

---------

Co-authored-by: Scott Anderson <scott@influxdata.com>
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-08-01 23:43:54 -05:00
Jason Stirnaman beeb428470 feat(v3): Add naming restrictions reference and guidelines:
- Fixes influxdata/DAR#515: discourages the use of a leading underscore in database and table names in all InfluxDB 3 versions, but doesn't disallow it
- Add detailed naming restrictions reference for all InfluxDB 3 versions
- Add basic guidelines in table and database creation guides.
- Core and Ent table guides are forthcoming in a separate PR
2025-07-10 16:10:27 -05:00
Jason Stirnaman 3dd7769062 fix(clustered): Warn about excessive table counts (closes influxdata/DAR#519):
- Addresses the core concern about catalog overhead
  affecting performance and stability
  - Explains that excessive depends on multiple factors
  (query latency, write bandwidth, cluster capacity)
  - Provides guidance about testing when doubling the
  default limit
2025-07-10 13:48:52 -05:00
Jason Stirnaman 55be385c5e fix(clustered): revise callouts and add expand for optional list command 2025-07-10 12:46:40 -05:00
Jason Stirnaman 4aba6b74ea
Update content/influxdb3/clustered/admin/backup-restore.md 2025-07-10 12:20:48 -05:00
Jason Stirnaman 7d75018a28
Update content/influxdb3/clustered/admin/backup-restore.md 2025-07-10 12:18:02 -05:00
Jason Stirnaman 0df51e51d3 fix(clustered): note snapshot storage and utilization costs:\
\
- Note callout: Focuses on the storage cost implications of enabling the setting
- Caution callout: Focuses on the risk of making recovery points unusable when disabled
2025-07-10 12:11:21 -05:00
Jason Stirnaman 573c1621dd feat(clustered): backup-restore instructions:- Add example commands for checking that replicas are active or shutdown- Add suggestion from @reidkaufmann for checking catalog and ingester counts when restoring.
- Add additional critical notes
2025-07-10 11:41:11 -05:00
Scott Anderson f42e0347d7 fix(clustered): updated clustered restore process, closes influxdata/DAR#520 2025-07-09 17:07:59 -06:00
Jamie Strandboge 2a9824f24b
chore: always verify GPG fingerprint
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.
2025-07-09 10:13:29 -05:00
Scott Anderson 0156a63a26
Merge branch 'master' into release-20250707-1777929 2025-07-08 14:38:33 -06:00
Jason Stirnaman 108e5e038c
Merge branch 'master' into jdstrand/use-modern-gpg-key 2025-07-08 15:30:20 -05:00
David Rusnak c8d03d6d59 docs: address PR comments 2025-07-08 16:22:50 -04:00
David Rusnak 5ccad4043e docs: add release notes and artifacts for 20250707-1777929 2025-07-08 16:08:04 -04:00
Jamie Strandboge 60abfdf562
chore: document and use modern influxdata-archive.gpg 2025-07-08 12:39:23 -05:00
Jason Stirnaman e92c82129a fix(api): curl --user syntax 2025-07-08 00:31:49 -05:00
Jason Stirnaman f349f3fa04 fix: codeblock format 2025-07-08 00:27:35 -05:00
Jason Stirnaman 48380fd168 fix(influxdb3): Auth schemes in 3core, 3ent, cloud-dedicated, and clustered:Explains compatibility for different schemasProvides more auth examplesFills missing schemes in API refFixes placeholdersShows that username is optional 2025-07-07 23:10:37 -05:00
Jason Stirnaman a06dd3c9cc
Merge branch 'master' into clarify-IdP-support 2025-07-03 15:59:44 -05:00
Jason Stirnaman 9b438f9647 fix(clustered): non-shared page using a 'version' link 2025-07-01 12:43:17 -05:00
Jason Stirnaman 490c57d024
Update content/influxdb3/clustered/admin/tables/delete.md 2025-07-01 09:33:58 -05:00
Scott Anderson 1e4f69bf6a task-based table and db management docs for dedicated and clustered 2025-06-30 16:13:30 -06:00
Scott Anderson 2fe551ddea
influxctl 2.10.2 (#6176)
* new commands for influxctl 2.10.2, moved some commands to shared

* influxctl 2.10.2 release notes

* Apply suggestions from code review

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

* Apply suggestions from code review

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

* Apply suggestions from code review

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

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-06-30 16:05:37 -05:00
Jason Stirnaman c9bc5e1e8e fix(clustered): release number should match files in downloads/clustered-release-artifacts 2025-06-23 16:27:51 -05:00
Scott Anderson e3e76b46d5 removed clustered release artifacts links without actual artifacts 2025-06-23 13:46:44 -06:00
Dustin Eaton 2815721f5f add release notes for 2025-06-18 Clustered release 2025-06-18 12:32:29 -05:00
Scott Anderson 27a276a564
Clustered release 20250613-1754010 (#6134)
* added release notes for jun 2025 clustered release

* updated clustered release number

* Update clustered.md

* corrected release number, added release artifacts
2025-06-13 14:01:43 -05:00
Scott Anderson 67963c8e56 hotfix: improved instructions for downloading clustered release artifacts manually 2025-06-10 16:15:00 -06:00
Scott Anderson f38ca674bf
Add release artifacts to Clustered release notes (#6132)
* WIP add build artifacts to clustered release notes

* added artifacts helper script, added artifacts, added artifact links to clustered release notes

* add instructions for downloading release artifacts manually

* added jq installation links
2025-06-10 16:57:08 -05:00
Adam S d177f373f9
Add influxdb namespace to identify version (#6044)
Add influxdb namespace to identify current InfluxDB Clustered package version, which matches the influxdb namespace example used to apply the updated image.

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2025-06-06 10:22:21 -05:00
Scott Anderson 48b7025fda
removed references to OCI in clustered, fix toc-contents js, closes influxdata/DAR#503 (#6125) 2025-06-05 17:38:26 -05:00
Jason Stirnaman 2169935012 fix(influxdb3): replace {{< product-name in headers with {{% to avoid the hahahugo anchor link bug.
- Still need to track down the root cause
2025-05-29 00:47:33 -05:00
Jason Stirnaman bf6c9ab4b3 hotfix(clustered): fix product name and remove dupe file 2025-05-19 18:05:55 -05:00
Jameelah Mercer 02c3a8bbbd
Update revoke 2.md
Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2025-05-16 14:18:31 -07:00
meelahme 18a4413933 docs(cli): add editable placeholders for database, table, and token in and examples 2025-05-15 12:28:30 -07:00
Scott Anderson 7fbf301fe2
Clustered fixes (#6062)
* updates AppInstance example for pausing, closes influxdata/DAR#486, closes influxdata/DAR#498

* clarify soft-deletes interactions with objects, closes influxdata/DAR#489

* add warning to use same clustered version in restore, closes influxdata/DAR#485
2025-05-13 14:37:37 -05:00
Scott Anderson 5435140582 hotfix: fix nav orphans and sorting, update clustered token delete to revoke 2025-05-13 09:25:11 -06:00