Support improvements week 5 and 6#547
Draft
manototh wants to merge 7 commits into
Draft
Conversation
The token permissions documentation did not clarify that basic API tokens are insufficient for ingesting OpenTelemetry traces and metrics. Users need advanced API tokens with both Ingest and Create permissions. Added a comparison table and a note to help users choose the right token type, especially when setting up OTel pipelines. Related support ticket: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KGJ83DKYF1BR19RCEMP9WA4K/ Co-authored-by: Cursor <cursoragent@cursor.com>
The dataset creation documentation did not explicitly list the available OpenTelemetry dataset kinds (Logs, Traces, Metrics), leaving users unsure which option to select. Users creating datasets for OTel traces could not find the correct kind. Also added an Export data section since users were asking how to download entire datasets. Related support tickets: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KG31Y6T9877FHK83WDPA58R5/ - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KFEHAEGC68FBTFQDESW7ZF66/ Co-authored-by: Cursor <cursoragent@cursor.com>
The heatmap documentation was minimal and lacked explanation of how to read the visualization. Users were confused about what the axes, color intensity, legend values, and bucket boundaries represent. Added a new section explaining how to interpret heatmaps and understand bucket boundaries. Related support ticket: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KGTS2AZ2F8H9GFX075NK1MNP/ Co-authored-by: Cursor <cursoragent@cursor.com>
The histogram documentation did not explain how bucket boundaries work, what the _bin column values represent, or the difference between the number_of_bins parameter and actual bin width. Users were confused about whether bin values represent bucket starts, ends, or centers, and how to verify their histogram definitions. Added sections on bucket boundaries, the number_of_bins parameter, and heatmap visualization. Related support ticket: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KGTS2AZ2F8H9GFX075NK1MNP/ Co-authored-by: Cursor <cursoragent@cursor.com>
Users were asking how to set up Terraform to forward AWS CloudWatch logs to Axiom, but the Terraform page did not mention this use case. Added a note with a link to the CloudWatch integration page which contains the Terraform module documentation. Related support ticket: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KFWWWCH1GRHP4D7X36C6AAXX/ Co-authored-by: Cursor <cursoragent@cursor.com>
The threshold monitor documentation mentioned the Notify by group option but did not clearly explain its behavior, particularly whether separate notifications are sent per group or bundled in a single message. Users expected separate Slack notifications per group but received bundled messages. Added a dedicated section explaining the behavior and a note about using custom webhooks for separate notifications. Related support ticket: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KG815TTP0HC0QW40APKKA5E0/ Co-authored-by: Cursor <cursoragent@cursor.com>
Users were experiencing issues where OTel traces did not appear in Axiom because they used basic API tokens instead of advanced tokens. The OpenTelemetry page used a generic prerequisites snippet that did not mention the need for advanced tokens with Ingest and Create permissions. Added a note clarifying both the token requirements and the importance of selecting the correct dataset kind. Related support tickets: - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KGJ83DKYF1BR19RCEMP9WA4K/ - https://app.plain.com/workspace/w_01HA1Z15QQY1X6QR29KFMBMYTH/thread/th_01KG31Y6T9877FHK83WDPA58R5/ Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.