Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
Warning
Grafana Assistant is currently in Private Preview - some or all features are subject to change without warning. If you are interested in trying it out, please sign up by filling out this form.
Get started
To get started with Grafana Assistant, you first need to sign up for the Private Preview.
Step-by-step guide
This guide will take you through the process of starting a conversation with the assistant, asking questions, performing investigations, and more. For more details on writing effective prompts, check out our Prompting guide.
1. Start a conversation
Once Grafana Assistant is enabled in your stack, you can start a conversation with the assistant by clicking on the new sparkle icon in the top-right corner of the Grafana UI.
2. Ask a question
Ask the assistant a general question, such as:
What are the best practices for monitoring Kubernetes?Now ask it a question that’s specific to your observability data, such as:
How many pods are we running?3. Get a response
The assistant will respond with chat replies as it works to answer your question.
If needed, it will query your data to provide a more accurate answer.
4. Give feedback
If you’re satisfied with the response, you can give the assistant a thumbs-up. If not, you can give a thumbs-down and provide feedback. This feedback is vital for us to improve the assistant.
5. Ask it to navigate
The assistant knows how to create deep links into other parts of the Grafana UI. You can ask it to show you specific things or navigate to pages to perform tasks.
Show me the `http_requests_total` metric in the appropriate Drilldown app- Try asking the assistant about signals specific to your data sources.
- Try asking it to take you to the Explore page to view the raw data.
- Try asking it to help you declare an incident (requires Grafana IRM).
6. Perform an investigation
The assistant can perform investigations by taking multiple steps.
For example, you can ask it to investigate an issue with a dashboard:
- Navigate to a dashboard that has a broken panel
Why is the X panel broken? Can you fix it?The assistant will perform multiple steps involving reading the dashboard, checking the query, generating a replacement query, and then applying the change back to the dashboard.
7. Create a dashboard from scratch
The assistant can help you create dashboards from scratch. Start by discussing something specific and get the assistant to successfully query some meaningful data.
Then ask it:
Can you use this data to create a dashboard? Include related data and alternative views where appropriate.The assistant will then create a dashboard for you.
8. Ask it anything
The best way to really understand what the assistant is capable of is to ask it questions and explore its capabilities.
Conclusion
In this guide, we covered how to:
- Start a conversation with the assistant
- Ask questions
- Perform investigations
- Create dashboards from scratch
- Navigate to different parts of Grafana
- Provide feedback
What’s next?
- Level up your prompting skills with our Prompting guide
- Check out the full list of features
- Browse the frequently asked questions
Was this page helpful?
Related resources from Grafana Labs
