Create page for the o11y demo on openo11y.dev
adrielp opened this issue · 4 comments
Overview
Create a new page to get started with the o11y demo.
This may require work to rebuild the o11y demo and fork it from open telemetry. This may be done after initial publication of site.
Currently thinking that we following the OpenTelemetry paradigm for forking the OTEL demo. There may be some intricacies when it comes to the DORA metrics and maintaining the fork, but it enables us to be listed as maintaining a fork. It also enables us to point to the source better and our contributions. The o11y-demo originally came from bits & pieces of the OTEL demo. Doing it this way will also pair nicely with the hosted demo where microservices are broken down.
I forked the OpenTelemetry demo into the Liatrio org and have a draft pull request up with the liatrio otel collector deployed optionally through the make start-delivery flag.
Currently working on porting over and fixing the Grafana dashboards due to older queries that aren't updatable.
One thing to note, which has been mentioned in the commits, is that using otlphttp for the metrics pushing to prometheus leads to dropped resource attributes. I've thus configured Prometheus in the demo & the collector with the Prometheus exporter to scrape from a port opened in the collector. This was found during the investigation of why the dashboards no longer work.
Currently leaving off with the draft PR that includes a new option for make start-dora. If you use this in conjunction with ngrok and a GitHub app (which I have created at the Liatrio org level called o11y-event-logging then you can emit event logs to your local demo.
Next steps are:
- tidy up the documentation
- write a utility to create a repo & run through automatically everything you would see to populate the events needed for the demo
- document that utility
Gonna write the utility in go and provide a golden path for go apps via a backstage template.