backstage / community-plugins

Community plugins for Backstage
Apache License 2.0
112 stars 84 forks source link

πŸš€ grafana: Make more information for alerts available #567

Open tlanfer opened 1 week ago

tlanfer commented 1 week ago

Plugin Name

grafana

πŸ”– Feature description

The grafana plugin could expose some more information about alerts through the grafanaApi it provides. Some of these would be very useful in the context of backstage, like for alert summary/description and example runbook_urls.

🎀 Context

When displaying alerts for a service its only somewhat useful to see the alert name. And jumping over into grafana can be very confusing, as the grafana UI is not exactly intuitive. I would like to show alerts in backstage, but also provide a summary of "what does this alert mean?!" and maybe even provide links to runbooks on how to handle those situations. Grafana already has this info, i would like for this to be available in backstage.

✌️ Possible Implementation

I already hacked together a rather ugly implementation for this which only works for unified alertings and bravely assumes the first alert instance has the information i need. I then made a simple accordion component to use these annotations, link to grafana and link to runbooks. I plan to have my people just write these runbooks as techdocs, so everythings is right there available in backstage.

image image I made my own UI component mainly to have something that looks clean and clear, especially if i add more information.

I am not exactly a seasoned typescript dev, but i can put together working code. Nor do i know the processes to get changes merged into backstage. I am willing to learn and create a PR though, if that would help.

πŸ‘€ Have you spent some time to check if this feature request has been raised before?

🏒 Have you read the Code of Conduct?

Are you willing to submit PR?

Yes I am willing to submit a PR!

awanlin commented 3 days ago

Hi @tlanfer, sounds good feel free to submit a PR! πŸš€