Commit Graph

44 Commits (683fd62ad5ac21ae27ee65b51f83ef406ac1c5b4)

Author SHA1 Message Date
Fraser Savage 9f0c7c6283
refactor(write-api): Punctuation and wording changes from code review
This makes the changes more consistent with wider writing style.

Co-authored-by: Jason Stirnaman <jstirnaman@influxdata.com>
2024-09-03 15:37:02 +01:00
Fraser Savage 8305b7cde4
fix(write-api): Partial writes now return a 400 response code in serverless
This updates some of the other wording around the troubleshooting table
to reflect the product's current state more closely.
2024-09-02 17:47:40 +01:00
Fraser Savage e448b6a223
fix(write-api): Serverless write requests outside retention return 400
Partial writes are the only mode of operation on serverless clusters.
This means that any requests where all points are outside the retention
policy of a bucket receive a 400 bad request.
2024-09-02 16:50:34 +01:00
Jason Stirnaman 4dc2033b99 fix(v3): apply correction, remove duplicate content, add links
- restore column limit defaults to 250
- remove duplicate content from schema-design

Co-authored-by: domodwyer <domodwyer@users.noreply.github.com>
2024-08-21 12:04:22 -05:00
Jason Stirnaman 57ed336ea2
Apply suggestions from code review
Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2024-08-20 16:44:44 -05:00
Jason Stirnaman 7f8bde4abf fix(v3): Update Cloud Dedicated and Clustered column limit to 1000 and clarify the potential impact of wide schemas. 2024-08-20 14:27:36 -05:00
Fraser Savage c83339029c
fix(write-api): Update Cloud Serverless outside-retention failure to HTTP 422 2024-08-09 15:45:38 +01:00
Jacob Marble ef61afc6ec fix(write-api): Serverless write 201 response codes
Helps https://github.com/influxdata/idpe/issues/18710

InfluxDB v3 Serverless will soon return 201 or 204, in cases where it
currently returns 204.
2024-08-07 12:57:04 -07:00
Jason Stirnaman 9d542dd8d6 fix: write-data section: consistent page titles, database and table nomenclature in dedicated and clustered 2024-06-25 11:51:26 -05:00
Jason Stirnaman bb166b0bdb fix: add serverless alt-links for influxctl 2024-06-24 16:14:07 -05:00
Jason Stirnaman 17c4315569 chore: Write data improvements
-  Format and structure serverless write-data
- Structure cloud-serverless write-data/line-protocol the same as clustered and dedicated to allow for adding more tool-specific pages.
- Make influxctl examples pass tests
2024-06-24 15:42:10 -05:00
Jason Stirnaman 8cda7285ca
fix: be explicit about srvls write 201 (#5328) 2024-02-16 12:47:41 -06:00
Jason Stirnaman 7479ceabf2
Revert "Revert "feature(v3): Write: partial writes write good lines and reject bad li… (#5169)" (#5280)" (#5304)
This reverts commit 624eb0205b.
2024-01-17 13:20:25 -06:00
Jason Stirnaman 9e276df194
Optimize writes: Use Telegraf to pre-process data before writing (#5282)
* chore(v3): preprocess writes (Telegraf, etc)

* feat: optimize writes using Telegraf

* WIP: dedup plugin

* WIP: Dedup

* chore(v3): Writes: Preprocess data using Telegraf: Dedup example

(#5155)
- Add example using processors.dedup in Telegraf.
- The plugin or configuration doesn't currently work as expected. Investigating...

* chore(v3): Write data: pre-process data using Telegraf

- Add Telegraf examples that pre-process data to avoid schema conflicts and reduce payload (bandwith, memory, etc.) when writing data.
- For Serverless. Will port to Dedicated and Clustered after approval.
- Doesn't include Dedup yet - I'm waiting on help to make it work (see branch https://github.com/influxdata/docs-v2/compare/issue5155-preprocess-with-dedup)

* Update content/influxdb/cloud-serverless/write-data/best-practices/optimize-writes.md

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>

* chore(test): Test harness setup, use golang base image

- Use golang base image for ease of Go environment setup. Installing Python separately is easier than Go.
- Add flag to bypass python warning about using system python and pip.
- Remove redundant env.products from pytest.ini; we already load it into environment variables.

* chore(v3): Optimize writes: Use Telegraf

Closes Telegraf guide: how to use the Converter processor to coerce data before writing #5155

- Adds use cases to Dedicated and Clustered docs
- Adds example for Execd processor plugin to all
- Clean up and pass tests
- Remove shared code sample

* fix(v3): Optimize writes: Placeholders and indent fixes

* Update content/influxdb/cloud-dedicated/write-data/best-practices/optimize-writes.md

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

* Update content/influxdb/cloud-serverless/write-data/best-practices/optimize-writes.md

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

* Update content/influxdb/clustered/write-data/best-practices/optimize-writes.md

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

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-12-22 11:23:49 -06:00
Jason Stirnaman d61107a3d3
feature(v3): Cloud Dedicated write API: partial writes write good lines and reject bad li… (#5273)
* feature(v3): Write: partial writes write good lines and reject bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- Updates Troubleshoot writes and API docs.

* chore(v3): update write status codes (#5160)

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* chore(v3): cleanup partial write descriptions in API ref and troubleshooting guide
2023-12-18 12:43:44 -06:00
Jason Stirnaman 624eb0205b
Revert "feature(v3): Write: partial writes write good lines and reject bad li… (#5169)" (#5280)
This reverts commit 90948e67dc.
2023-12-15 09:27:57 -06:00
Jason Stirnaman 90948e67dc
feature(v3): Write: partial writes write good lines and reject bad li… (#5169)
* feature(v3): Serverless write API: writes good lines, rejects bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- If some points are written, returns 201 status code.
- Updates Troubleshoot writes and API docs.

* feature(v3): Serverless write API: writes good lines, rejects bad lines #5160

- Documents the proposed partial writes feature for Serverless and Dedicated.
- If some points are written, returns 201 status code.
- Updates Troubleshoot writes and API docs.

* fix: Serverless cleanup

* fix: Serverless write API: restore 204 and explain 201 and 400 status codes.

* Apply suggestions from code review

* fix: Serverless write API: 201 superseded by 204 to maintain v2 compat.

- Documents https://github.com/influxdata/idpe/pull/18398.

* fix: Serverless write API: 201 superseded by 204 to maintain v2 compat.

- Documents https://github.com/influxdata/idpe/pull/18398.

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md
2023-12-13 16:20:51 -06:00
Jason Stirnaman 5649770e06
Fix-5226 v2 and v3 series inaccuracy (#5264)
* fix(v2): series keys in OSS

closes #5226

- Fix v2 series keys definitions
- Remove field key from OSS description
- Update glossary and schema-design.

* fix(v3): rejected points reason

closes Fix series definitions and reasons for rejected points #5226
- Replaces series with partition in reasons for rejected points.
2023-12-06 16:25:37 -06:00
Jason Stirnaman de0f526bdf
Reorganize Serverless DBRP for v1 queries and writes, explain DBRP and auto bucket defaults (#5257)
* chore(v3): DBRP: Update Serverless API ref (#5234)

* chore(ci): Tests: substitute placeholders in JSON body parameters

* chore(v3): DBRP: copy page from influxql to admin/dbrps.

* chore(ci): Trying to prevent "a Influx..."

* chore(ci): Allow autogen

* chore(serverless): DBRP glossary entry

* chore(v2): add default DBRP note

* chore(v3): use product-name shortcode

* chore(v3): use product-name shortcode, clarify retention period and mapping

* chore(serverless): Create Bucket:

- add missing example for Data Explorer
- move Retention Period syntax and define retentionRules syntax
- setup for tests

* chore(serverless): Create Bucket:

- add missing example for Data Explorer
- move Retention Period syntax and define retentionRules syntax
- setup for tests

* chore(serverless): Update bucket: alias to match other products

* chore(v3): Serverless for prototyping: update with DBRP behavior

* Serverless auto-generated buckets have 3-day default retention period
Fixes #5234

- v1-compat guide:
  - passes tests
  - explains DBRPs (default, automatic, and management)
  - migrate DBRP content from query-data/influxql/dbrp
- v2-compat guide:
  - fix TOC
  - add list code example
- rename influxdb-v1-api to api/v1-http, migrate params from v1-compat guide, and explain DBRP in context
- add write-data/api/v1-http and migrate content from v1-compat guide
- move optimize and troubleshooting up to /query-data
- add Related items support for paths containing http
- substitute placeholders in tests

* chore(test): update configuration in README

* fix(serverless): Optimize queries parent

* fix(serverless): create-bucket cleanup

* fix: cleanup

* fix: close tag

* 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>

* fix(v3): permission to create dbrp-mapped bucket

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-12-05 16:48:25 -06:00
Scott Anderson cbd2a0b72a
Update mentions of IOx to v3 (#5256)
* update mentions of IOx to v3

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-11-30 11:52:40 -07:00
Jason Stirnaman 5c74bf4ff6
5156 Writes: add v1 to Serverless get-started (#5233)
* chore(ci): Install Telegraf to test container

* chore(v3): test telegraf config and startup:

- creates the config file for the test run. TODO: remove the duplication and use the content for test setup.
- fix placeholder name

* fix(v3): make test pass for curl API example

* chore(ci): make tests pass for write. Add dependencies to Dockerfile.

* chore(tests): update test build

- Compose metadata: Add profile to test service. We can decouple services later and apply the profile to each. Rename. Pass the image name to the container.
- Fetch the parse_yaml.sh script during docker build, so we only fetch when necessary. Track the script in git. This is still a little janky, but better.
- test.sh: Use `HEAD` for diff (duh). Go back to using docker compose up so we're rebuilding only as needed and reusing the container - much faster, but the output isn't as pretty as `run`.
- pytest.ini, requirements.txt: Use pytest-dotenv to load env.products variables.

* fix(write): update JS instructions and pass tests.

* chore(ci): Install influx v2 CLI into the Docker test container.

* chore(ci): move .env file loading to pytest and run product tests separately with the proper .env file:

- Moves .env configs to be loaded by the test runner instead of by Docker. I'd prefer to ignore any product divergence and have them run interchangeably, but the pros outweigh the cons for now.
- Add example for passing custom commands in the compose file.

* fix(v3): replace curl example with v1 and v2, simplify JS example, pass tests.

feat(v3): add v1 write, test, update text:

- adds Serverless v1 /write example with note about autogen behavior
- adds link from v1 examples to Migrate guide
- adds description of autogen behavior to v1-compat guide
- updates "powered by..." text
- adapts examples to make them more testable, asserts `/write` status code
- replace "shared" examples (only used once) with inline to make them testable

fix(v3): promote migrate link

* Update content/influxdb/cloud-dedicated/get-started/write.md

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 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 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>

* chore(v3): Write: fix wording for curl success  (#5156)

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-11-15 14:41:29 -06:00
Scott Anderson 636f5ada45
V2 nav reorg (#5213)
* nest reference docs menu in v2 and cloud

* move migrate data into write data

* nest notebooks under tools

* nest templates under tools

* nest telegraf configs under tools

* cleanup weights and titles of tools sections

* reorg org and bucket management under admin

* add backup/restore to admin, clean up related links

* restructure security sections under admin

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* updated serverless cli docs to address pr feedback

* Update content/influxdb/cloud/admin/organizations/delete-org.md

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* port v2 install changes to new structure

* address pr feedback and ported missing content to serverless

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-11-06 15:53:12 -07:00
Jason Stirnaman abf60c9b69
chore(v3): There is no index of Tag Values, Tag Values are "just data" in IOx. #5097 (#5202)
- Fix example

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-10-30 09:03:49 -05:00
Jason Stirnaman c4ccc191b6
fix(v3): remove v2-prefer note, replace with specific recommendations (#5195)
* fix(v3): remove v2-prefer note, replace with specific recommendations

- removes the shared v2-prefer shortcode note.
- adds "Flight client" tag to all Flight RPC and Flight SQL client pages.
- replaces the note with specific write/query notes in each platform.
- misc fixes

* fix(v3): v2 client library typo

* fix(v3): Cleanup usage note for all v2 client libraries

- Change note to warning
- Condense
- Move warning to prepend block
- Make consistent on all pages
- Remove autolinking to GitHub repos

* chore(v3): Add "Clustered"

* fix(v3): typo
2023-10-26 14:45:38 -05:00
Jason Stirnaman 237b01877b
chore(qol): Test python and shell code samples. WIP - use for local testing only, not ready for CI. (#5154)
- Adds a Docker image, scripts, and configuration that install and run pytest-codeblocks on Python and shell code samples in Markdown.
- Copied from https://github.com/jstirnaman/docs-codeblocks/
- TODO: The script copies files into a tmp directory configured as a bind mount for the Docker container. We might want to replace this with the experimental `watch` feature.
- TODO: Use a secret to configure the token. As is, values subbed from the dotenv file are exposed in your Docker container history.
2023-09-26 14:56:21 -05:00
Jason Stirnaman e0bafcd9a1
fix: fix v3 write descriptions, Add v3 Troubleshoot writing data #5135 (#5140)
* fix: fix v3 write descriptions, Add v3 Troubleshoot writing data #5135

* Update content/influxdb/cloud-dedicated/write-data/troubleshoot.md

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

* Update content/influxdb/cloud-serverless/write-data/troubleshoot.md

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

* Update content/influxdb/clustered/write-data/troubleshoot.md

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

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-09-18 13:03:47 -05:00
Scott Anderson 35ad46c4c2
Version restructure (#5133)
* mass changes for version restructure

* fixed latest-patch and flux version generator

* updated hugo configs

* fixed flux frontmatter injector

* fixed flux frontmatter injector

* WIP api generator updates for version restructure (#5128)

* fixed telegraf plugin list

* removed latest shortcode

* fixed current-version

* fixed product dropdown crosslinking

* fixed alt links

* WIP fixing links

* fixed broken links

* updated api doc generation

* fixed additional resources

* added version redirects to edge.js

* fixed search placeholder

* fixed paged titles
2023-09-12 23:33:31 -06:00
Scott Anderson 471ee4561d
InfluxDB Clustered documentation (#5126)
* WIP base changes for clustered docs

* WIP clustered docs

* Add new influxdb/host shortcode and implement it in 3.0 docs (#5077)

* add new influxdb/host shortcode and implement it in 3.0 docs

* remove oss- cloud-only shortcodes from serverless

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* updated urls js to PR suggestion

* Updated JavaScript, templates, and styles for Clustered URLs (#5079)

* updated js, templates, and styles for clustered urls

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* restructure product dropdown template to be more extensible

* fixed more page template bugs

* fixed references to cloud in clustered

* updated docsearch templates

* added early access flagging and cta-link shortcode

* minor content updates in clustered

* updated staging config

* fixed typo in clustered description

* ported influxctl 2.0.1 to clustered

* ported get started changes to clustered

* ported 3.0 admin docs to clustered

* port null tag content to clustered

* ported influxctl note to clustered

* ported query reorg changes to clustered

* updated early access to limited availability, updated clustered landing content

* ported new content to clustered

* ported new content to clustered

* updated cta on clustered landing page

* Updated notifications and added InfluxDB Clustered announcement notification (#5125)

* updated notifications, added clustered announcement notification

* updated cta in clustered notification

* updated influxctl profile configs

* update clustered search attributes

* updated learn more link in clustered notification

* Apply suggestions from code review

* fixed typos

* fixed typos

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-09-06 06:21:47 -06:00
Scott Anderson 0606902380
New Guides section, Serverless as an evaluation and prototyping platform (#5118)
* added new guides section to serverless and dedicated, fixed bug, closes #4978

* added serverless prototyping and evaluation document

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* remove dbrp relevance statement

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-08-30 14:58:29 -06:00
Jacob Marble 1f38e3f7a8 chore: explain null tags in primary keys 2023-08-24 16:50:42 +00:00
Jason Stirnaman 3dbf0e7554
Move IOx limits page to limits and adjustable quotas page (#5089)
Fixes #4915
2023-08-15 14:52:31 -05:00
Jason Stirnaman 9404fda2f3
chore(ci): Add vale script, configuration, and fixes (#5081)
- Adds VSCode directory-specific configurations for Vale
- Adds a simple shell script to run Vale for dedicated, serverless, and telegraf.
- Adds vocab and spelling configuration.
- Fixes some spelling and style errors in serverless and dedicated.
2023-08-11 13:50:31 -05:00
Jason Stirnaman c5a2e965c8
fix(influx-cli): broken serverless/tools/influx-cli links (#5057)
- Fixes Page not found - Configure influx cli - use the influx cli button #5045
- Copies influx-cli download and installation instructions to influx reference, which is shared across oss, cloud, and cloud-serverless.
- Replaces links pointing to the nonexistent path /influxdb/cloud-serverless/tools/influx-cli and adds an alias for the path.
2023-07-27 16:37:55 -05:00
Jason Stirnaman 46a062948f
Remove flux from Dedicated and Serverless docs. (#5014)
* chore(v3): remove Flux

* chore(v3): remove Flux: flux-sql.md

* chore(v3): Remove Flux: reference

* chore(v3): Remove Flux: Reference, set aliases for removed pages

* chore(serverless): Remove Flux: Glossary

* Update content/influxdb/cloud-serverless/query-data/sql/execute-queries/data-explorer.md
2023-07-10 17:16:52 -05:00
Jason Stirnaman ec4afbd259
Dar 390 contact support (#5003)
* chore(cloud): Remove support from billing (https://github.com/influxdata/DAR/issues/390)

* chore(cloud): Remove support from limits (https://github.com/influxdata/DAR/issues/390)

* fix(serverless): Add related and fix aliases.

* chore(cloud): Remove and update Support contact (https://github.com/influxdata/DAR/issues/390)

* chore(serverless): Remove and update Support contact (https://github.com/influxdata/DAR/issues/390)

* fix(serverless): Alternatives to deleting data, update measurement/table entries in glossary.

* chore: Update Support footer.

* hotfix: cloud-only tags in glossary

* chore(docs): Update storage-limits to remove directions to contact support (#4996)

* chore(docs): Update storage-limits to remove directions to contact support
Support are not able to increase these limits on the serverless product.  If customers need higher limits they should speak to sales about a dedicated solution in the first instance.

* chore: fix hyperlink to sales

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Update content/influxdb/cloud-serverless/admin/billing/_index.md

Co-authored-by: Ben Tasker <88340935+btasker@users.noreply.github.com>

* Update content/influxdb/cloud/account-management/billing.md

Co-authored-by: Ben Tasker <88340935+btasker@users.noreply.github.com>

* fix(serverless): measurement suggestions

Co-authored-by: Ben Tasker <88340935+btasker@users.noreply.github.com>

* Update content/influxdb/cloud-serverless/reference/internals/storage-limits.md

---------

Co-authored-by: Will Cooke <will@whizzy.org>
Co-authored-by: Ben Tasker <88340935+btasker@users.noreply.github.com>
2023-06-30 09:39:45 -05:00
Scott Anderson 4df36bacc9 hotfix: minor updates to dedicated and serveriless optimize writes 2023-06-21 10:06:12 -06:00
Scott Anderson 7246eb647b
Port "Optimize writes" guide to Serverless and Dedicated (#4973)
* port optimize writes guide to serverless and dedicated

* updated dedicated lp guide
2023-06-21 09:55:11 -06:00
Jason Stirnaman 0eb12c1a62
Fix 4965 update py library name (#4971)
* wip(query): cleanup, but broken formatting

* fix(serverless): sync get-started query with dedicated, cleanup

* fix(dedicated): sync get-started/query with serverless, cleanup

* fix(dedicated): get-started/write cleanup

* fix(serverless): update python client name in get-started/write

* fix(dedicated): add links to query tools

* fix(serverless): port view-orgs from cloud, link setup to view-orgs

* fix(serverless): js client lib - add links to token and org pages

* fix(v3): grafana cleanup

* fix(serverless): cleanup telegraf config examples

* fix(v3): cleanup write CSV with telegraf

* fix(v3): telegraf config cleanup

* fix(v3): update python client library
2023-06-07 08:43:57 -05:00
Jason Stirnaman 1b2dfe7e2f
chore(v3): add Telegraf examples, configuration, dual-write (#4929)
-  Add Telegraf examples to get-started/write-data (#4918)
- Update instructions for saving the token, using secret store
- Instructions for setting and using environment variables, add Windows examples
- For Dedicated, make manual-config the config default
2023-06-05 12:12:03 -05:00
Jason Stirnaman a04ef07c3e
docs(v3): construct points and write line protocol (#4964)
* docs(v3): construct points and write line protocol

- use Go, Python, and Node.js client libraries to construct points and write line protocol to InfluxDB Cloud Serverless or Dedicated.

* Update content/influxdb/cloud-dedicated/write-data/line protocol/_index.md

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

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-05-31 17:12:00 -05:00
Jason Stirnaman 1f64b24893
Fix api related links (#4956)
* wip: fix serverless api related links.

* fix(serverless): remove, replace, alias broken links, and/or mark for pending content

- See the annotated link checker report.
(closes 404s for links in Cloud Serverless API reference #4955)
2023-05-25 16:36:05 -05:00
Scott Anderson 3f8f0e0c5b
Port pricing and billing pages to Serverless (#4921)
* port pricing and billing pages to serverless

* fix altengine frontmatter

* added missing alt_engine frontmatter

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* address PR feedback

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-05-05 12:52:41 -06:00
Jason Stirnaman 13eddccde0
fix(v3): misc. fixes for Telegraf, examples, bucket schemas (#4912)
* fix(serverless): telegraf env var syntax and placeholder description.

* chore(serverless): add links for outputs.influxdb_v2 example

* fix(dedicated): syntax in telegraf config example

* fix(serverless): for v3, discourage use of bucket schemas

- add a warning to discourage use of bucket schemas
- remove create instructions

* fix(telegraf): update environment variable doc and examples to match Telegraf config documentation

- https://github.com/influxdata/telegraf/tree/master/config

* Update content/influxdb/cloud-dedicated/write-data/csv/telegraf.md

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

---------

Co-authored-by: Scott Anderson <sanderson@users.noreply.github.com>
2023-04-27 20:04:48 -05:00
Scott Anderson 6223ef0ecd
Cloud Dedicated documentation (#4903)
* base changes for influxdb cloud dedicated

* removed unnecessary whitespace from dedicated homepage

* influxctl reference documentation (#4855)

* influxctl reference docs

* fixed typo, added auth0 token life span

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* more updates to influxctl docs

* update influxctl docs to address PR feedback

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Add admin and manage databases sections to Cloud Dedicated (#4857)

* add admin and manage databases sections

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* added missing page descriptions to admin docs

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Add token management documentation to Cloud Dedicated documentation (#4861)

* add manage tokens documentation to dedicated

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* update admin token docs to address PR feedback

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Dedicated get started (#4878)

* WIP dedicated get started content

* fix(cst): infinite cardinality (#4851)

* WIP cloud dedicated get started

* feat(cloud-dedicated): WIP - write data to Cloud Dedicated

* fix(cloud-dedicated): grammar.

* feat(cloud-dedicated): WIP outline write methods, v1 API use

* fix(cloud-dedicated): dupe name.

* updated staging config, fixed dedicated page titles

* updated dedicated setup doc

* Cloud Dedicated primers v1 API: auth and write (#4865)

* feat(cloud-dedicated): v1 API with Cloud Dedicated
- Add /primers >> /api >> /v1 and /v2
- Move draft started in /write-data to /primers/api/v1
- Created code samples that still need testing
- v1 authentication schemes.

* fix(cloud-dedicated): list children pages

* wip(cloud-dedicated): v1 primer intro

* wip(cloud-dedicated): auth fixes.

* feat(cloud-dedicated): v1 API primer
- part of #4863, #4864
Still untested against CST:
- v1 auth methods
- v1 /write
  - Telegraf config
  - Precision
  - API sample code

* Update content/influxdb/cloud-dedicated/primers/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/_index.md

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md

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

* Update layouts/shortcodes/api/cloud/v2-prefer.html

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

* Update shared/text/api/cloud-dedicated/basic-auth.js

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

---------

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

* Dedicated v1 write (#4873)

* wip(v1): Revise v1 and add client library info.

* feat(cloud-dedicated): primer v1 API auth and writes

- Fixes for v1 auth and writes
- Configuring node and python v1 client libraries for Cloud Dedicated.

* fix(cloud-dedicated): v1 intros:

- Fix redundant intro
- Query intros

* Apply suggestions from code review

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

---------

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

* Dedicated v2 write (#4875)

* fix(cloud-dedicated): v1 API primer:

- fix typo
- fix description

* wip(cloud-dedicated): v2 auth, write, Telegraf

* feat(cloud-dedicated): v2 API primer (#4874)

- v2 authentication
- Write using /api/v2/write
- Cleanup in v1

* Update content/influxdb/cloud-dedicated/primers/api/v2/_index.md

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

* Update content/influxdb/cloud-dedicated/primers/api/v1/_index.md

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

* Update shared/text/api/cloud-dedicated/token-auth-v2-write.sh

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

* fix(cloud-dedicated): parameters for v1 and v2 writes

- testing proves that org can't be empty

Ongoing:
- writes with v2 client library appear to work, but I can't find the measurement when I query.
- v1 writes with curl respond with 404.

---------

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

* Add Python and Go write instructions to Cloud Dedicated get started (#4876)

* added python and go write instructions to dedicated get started

* Add get started query guide to dedicated (#4877)

* Add get started query guide to dedicated

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Apply suggestions from code review

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Port reference content into dedicated (#4879)

* ported line protocol and sql reference

* port glossary to dedicated

* fix(cloud-dedicated): cleanup (#4880)

* fix(cloud-dedicated): v1 parameter values

- Fixes parameter values in requests.
- Based on inspection of the request (default port, content-type headers).
- Still not working in CST.

* fix(cloud-dedicated): cleanup auth description and list query tools.

* fix(cloud-dedicated): cleanup auth examples:

- remove boilerplate JS examples. Eventually replace with client lib examples.
- fix incorrect URL
- replace localhost with cloud2 host

* fix(cloud-dedicated): replace placeholders

* Add support for custom dedicated URLs (#4882)

* add support for custom dedicated urls

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* removed unnecessary conditional in influxdb-urls.js

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* add information about flight sql support (#4894)

* Update influxctl install and setup instructions (#4893)

* updated influxctl install and setup instructions

* added details to influxctl init page

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Dedicated query data (#4895)

* WIP port query data section to dedicated

* updated database-name to iox-namespace-name

* updated grafana instructions

* update grafana install instructions

* updated images and links

* fixed broken links in query data section

* fix(cloud-dedicated): get-started write (#4890)

* fix(cloud-dedicated): package name typo

* fix(cloud-dedicated): URL missing query

* fix(cloud-dedicated): iox-namespace-name

* fix(cloud-dedicated): use get-started database name

* fix(cloud-dedicated): add auth-specific examples.

* fix(cloud-dedicated): use Bearer for v2 example

* fix(cloud-dedicated): add a note about token schemes and link to primer.

* fix(cloud-dedicated): org no longer required by API, remove from curl example

* fix(cloud-dedicated): use Bearer

* fix(cloud-dedicated): wordsmithing

* fix(cloud-dedicated): file name

* fix(cloud-dedicated): Go client works without org

* fix(cloud-dedicated): separate the commands for copy-pasting

* fix(cloud-dedicated): v1 API token authentication

* fix(cloud-dedicated): org parameter ignored, but needed in python clients

* fix(cloud-dedicated): v1 API examples and params for /query (#4897)

* fix(cloud-dedicated): minor word change (#4898)

* New homepage and structural changes (#4899)

* WIP first sweep of cloud-iox to cloud-serverless

* WIP iox to serverless content updates

* WIP iox to serverless updates in page templates and data files

* WIP new homepage

* chore(dedicated): copy best-practices from serverless

* fix(serverless): missing shortcut

* new homepage

* fix(dedicated): token links in v1 API primer

* chore(dedicated): write csv with Telegraf

* fix(serverless): write CSV with Telegraf

* updated homepage styles

* updated deps, fix unclosed shortcodes, fix light css

* fix product selector order

* updated database naming restrictions, add resource delete confirmation

* add cloud-ios to cloud-serverless redirect to edge.js

* remove sh from allowed extentions

* fix bug in redirect logic

* add sections to product dropdown (#4900)

* minor homepage css adjustment

* fixed page titles

* fixed more iox references in templates

* Apply suggestions from code review

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* Migrate 1.x data to dedicated (#4901)

* fix(serverless): cleanup

* chore(dedicated): Migrate 1.x data to dedicated

- Minimal adaptation of IOx to Dedicated for now.
- Use APIs for writing data (CLIs? pyinflux3 only writes CSV? Can't promote influxdb_iox for now)
- Add 2.x CLI warning

* fix(dedicated): URL typos

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/_index.md

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

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md

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

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md

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

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md

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

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md

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

* Update content/influxdb/cloud-dedicated/write-data/migrate-data/migrate-1x-to-cloud-dedicated.md

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

---------

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

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>

* add step for requesting a cluster in dedicated setup

* minor content fixes in best practices

---------

Co-authored-by: Jason Stirnaman <stirnamanj@gmail.com>
2023-04-26 08:03:37 -06:00