Skip to content

Docs: Updated Athena data source docs#790

Open
lwandz13 wants to merge 11 commits intomainfrom
docs/update-amazon-athena
Open

Docs: Updated Athena data source docs#790
lwandz13 wants to merge 11 commits intomainfrom
docs/update-amazon-athena

Conversation

@lwandz13
Copy link
Copy Markdown

@lwandz13 lwandz13 commented Mar 5, 2026

Summary
Restructures the Amazon Athena data source documentation from a single monolithic _index.md into a multi-page doc set following Grafana's data source documentation standards.

Changes
New structure (docs/sources/):

  • _index.md -- Overview, supported features, pre-built dashboards, plugin updates
  • configure.md -- Configuration settings, AWS authentication, IAM policies, provisioning examples
  • query-editor.md -- Query editor fields, format options, macros, async queries, query result reuse
  • template-variables.md -- Variable types, query examples, usage in queries
  • annotations.md -- Annotation columns, example queries
  • alerting.md -- Alert rule setup, query requirements, performance considerations
  • troubleshooting.md -- Authentication, connection, query, and performance issues (new content based on codebase error analysis)

Style and accuracy fixes applied across all pages:

  • Added YAML frontmatter (description, keywords, labels, menuTitle, title, weight, last_reviewed, aliases)
  • Verified supported features against plugin.json (corrected Logs from Yes to No, added Traces: No)
  • Documented previously undocumented features: Logs format option, resource selectors with template variable support, Max Age in Minutes for query result reuse, context-aware autocompletion
  • Documented pre-built dashboards (Cost Usage Report Monitoring, Amazon VPC Flow Logs)

@lwandz13 lwandz13 requested review from irenerl24 and zoesyc March 5, 2026 15:06
@lwandz13 lwandz13 self-assigned this Mar 5, 2026
@lwandz13 lwandz13 requested a review from a team as a code owner March 5, 2026 15:06
@lwandz13 lwandz13 requested review from kevinwcyu and njvrzm March 5, 2026 15:06
@lwandz13 lwandz13 added the type/docs Improvements or additions to documentation label Mar 5, 2026
@cla-assistant
Copy link
Copy Markdown

cla-assistant bot commented Mar 5, 2026

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

1 similar comment
@cla-assistant
Copy link
Copy Markdown

cla-assistant bot commented Mar 5, 2026

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@lwandz13 lwandz13 requested a review from a team as a code owner April 7, 2026 19:47
@lwandz13
Copy link
Copy Markdown
Author

lwandz13 commented Apr 7, 2026

@kevinwcyu I made the requested changes - can you re-review? Thank you!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type/docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants