-
Notifications
You must be signed in to change notification settings - Fork 569
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add scheme to DNS service discovery docs #3450
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for opening this PR! The issue you raised is interesting. The doc page docs/sources/operators-guide/configure/about-dns-service-discovery.md
is a generic one about the DNS-based service discovery. In the example you edited there (memcached one) it's correct to not have a schema (e.g. memcached protocol is not HTTP based). However, when you use the DNS-based service discovery with the alertmanager, you need to set the scheme there.
We can do few things to clarify it:
- In
docs/sources/operators-guide/configure/about-dns-service-discovery.md
, mention the scheme is required when referencing the config option-ruler.alertmanager-url
- We can improve the CLI flag description here to clarify it there as well
Thank you, @pracucci. I've updated the PR. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM. Could you run make reference-help doc
to update the auto-generated doc, please? @osg-grafana can you take a final look at the copy, please?
The missing schema leads to errors like `improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)`.
docs/sources/operators-guide/configure/about-dns-service-discovery.md
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Unblocking with feedback
…very.md Co-authored-by: Ursula Kallio <[email protected]>
Co-authored-by: Marco Pracucci <[email protected]> Add scheme to DNS service discovery docs (grafana#3450) * Add schema to DNS service discovery docs The missing schema leads to errors like `improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)`. * Update docs/sources/operators-guide/configure/about-dns-service-discovery.md Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> Co-authored-by: Ursula Kallio <[email protected]> Alertmanager configuration validate-only mode grafana#3437 (grafana#3440) * Alertmanager configuration validate-only mode grafana#3437 * Documentation update for alertmanager config validation * Update changelog * Update docs/sources/operators-guide/architecture/components/alertmanager.md Co-authored-by: Ursula Kallio <[email protected]> * Swap a command line flag for a verify subcommand. * Update pkg/mimirtool/commands/alerts.go Co-authored-by: Marco Pracucci <[email protected]> * For loop to reduce repetition * Use review suggestion. * Make alertmanager verification docs more consistent. Bump from enhancement to feature. * fmt * Fix the golint issue. * Fix typo * Make doc result (as specified by lint process) Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> lint fix
* add runbook urls for alerts Co-authored-by: Joshua Hesketh <[email protected]> Update CHANGELOG.md Co-authored-by: Joshua Hesketh <[email protected]> * Update CHANGELOG.md Co-authored-by: Marco Pracucci <[email protected]> Add scheme to DNS service discovery docs (#3450) * Add schema to DNS service discovery docs The missing schema leads to errors like `improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)`. * Update docs/sources/operators-guide/configure/about-dns-service-discovery.md Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> Co-authored-by: Ursula Kallio <[email protected]> Alertmanager configuration validate-only mode #3437 (#3440) * Alertmanager configuration validate-only mode #3437 * Documentation update for alertmanager config validation * Update changelog * Update docs/sources/operators-guide/architecture/components/alertmanager.md Co-authored-by: Ursula Kallio <[email protected]> * Swap a command line flag for a verify subcommand. * Update pkg/mimirtool/commands/alerts.go Co-authored-by: Marco Pracucci <[email protected]> * For loop to reduce repetition * Use review suggestion. * Make alertmanager verification docs more consistent. Bump from enhancement to feature. * fmt * Fix the golint issue. * Fix typo * Make doc result (as specified by lint process) Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> lint fix Co-authored-by: Joshua Hesketh <[email protected]>
* Add schema to DNS service discovery docs The missing schema leads to errors like `improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)`. * Update docs/sources/operators-guide/configure/about-dns-service-discovery.md Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> Co-authored-by: Ursula Kallio <[email protected]>
* add runbook urls for alerts Co-authored-by: Joshua Hesketh <[email protected]> Update CHANGELOG.md Co-authored-by: Joshua Hesketh <[email protected]> * Update CHANGELOG.md Co-authored-by: Marco Pracucci <[email protected]> Add scheme to DNS service discovery docs (grafana#3450) * Add schema to DNS service discovery docs The missing schema leads to errors like `improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)`. * Update docs/sources/operators-guide/configure/about-dns-service-discovery.md Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> Co-authored-by: Ursula Kallio <[email protected]> Alertmanager configuration validate-only mode grafana#3437 (grafana#3440) * Alertmanager configuration validate-only mode grafana#3437 * Documentation update for alertmanager config validation * Update changelog * Update docs/sources/operators-guide/architecture/components/alertmanager.md Co-authored-by: Ursula Kallio <[email protected]> * Swap a command line flag for a verify subcommand. * Update pkg/mimirtool/commands/alerts.go Co-authored-by: Marco Pracucci <[email protected]> * For loop to reduce repetition * Use review suggestion. * Make alertmanager verification docs more consistent. Bump from enhancement to feature. * fmt * Fix the golint issue. * Fix typo * Make doc result (as specified by lint process) Co-authored-by: Ursula Kallio <[email protected]> Co-authored-by: Marco Pracucci <[email protected]> lint fix Co-authored-by: Joshua Hesketh <[email protected]>
The missing schema leads to errors like
improperly formatted alertmanager URL "alertmanager.mimir.svc.cluster.local:8080/alertmanager" (maybe the scheme is missing?)
.CHANGELOG.md
updated - the order of entries should be[CHANGE]
,[FEATURE]
,[ENHANCEMENT]
,[BUGFIX]