docs: Issue with "First steps with Prometheus"
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 717
- Forks
- 1.2k
- Avg merge
- 3d 15h
- Merged PRs (30d)
- 19
Description
Page: https://prometheus.io/docs/introduction/first_steps/
Describe the issue:
My overall goal is to capture Opentelemetry data and display it. I'm an experienced mainframe person, but have only just started using prometheus.
I've been through the getting started, and I'm stuck on what next. I'm looking for the step after getting started.
From status -> health I believe I have connected opentelemetry to Prometheus both running in docker, but I do not know if any data is flowing
It would be good if you could provide instructions on the second step
For example
- Provide some sample data in a file.
- Explain how I know what data I can query. For example the documentation mentions promhttp_metric_handler_requests_total. How do I list the available fields, so I can use them in a query. In the OTEL records, there are many fields.
- I issued a curl query and got a list of fields, but it does not have any records from OTEL. How am I meant to know what fields are available?
- Provide a metric records_processed and it shows all the scrapers - their status and how many records they have processed ( and perhaps last read time)
- Then as part of the second step say issue the query.... to show how many records you have read from which source.
Third step.
Im not sure if I can provide saved queries to save me having to type long queries every time.
The third step should provide an example of creating/editing/deleting a saved rule on the sampled data provided
This information may already exist - I just can't find it.
Thank you
Colin Paice
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the “First steps with Prometheus” page at docs/introduction/first_steps/. Review the existing getting-started flow and determine where instructions for checking OpenTelemetry data, discovering queryable metrics, and creating saved rules would fit. Done means the page provides sample data plus clear second- and third-step examples for querying it and managing a saved rule.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- prometheus
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 42/100