luxolus/open-consul
2
0
Fork 0
Code Issues 1 Pull requests Packages Releases Wiki Activity
open-consul/docs/service-discovery/health-checks.md
cskh 53ff317b01
fix: missing UDP field in checkType (#14885) 
* fix: missing UDP field in checkType

* Add changelog

* Update doc
2022-10-05 15:57:21 -04:00

2.1 KiB
Raw Blame History

Health Checks

This section is still a work in progress.

agent/checks contains the logic for performing active health checking.

Check Registration flows

There are many paths to register a check. Many of these use different struct types, so to properly validate and convert a check, all of these paths must be reviewed and tested.

  1. API /v1/catalog/register - the Checks field on structs.RegisterRequest. The entrypoint is CatalogRegister in agent/catalog_endpoint.go.
  2. API /v1/agent/check/register - the entrypoint is AgentRegisterCheck in agent/agent_endpoint.go
  3. API /v1/agent/service/register - the Check or Checks fields on ServiceDefinition. The entrypoint is AgentRegisterService in agent/agent_endpoint.go.
  4. Config Checks - the Checks and Check fields on config.Config in agent/config/config.go.
  5. Config Service.Checks - the Checks and Check fields on ServiceDefinition in agent/config/config.go.
  6. The returned fields of ServiceDefinition in [agent/config/builder.go].
  7. CLI consul services register - the Checks and Check fields on api.AgentServiceRegistration. The entrypoint is ServicesFromFiles in command/services/config.go.
  8. API /v1/txn - the Transaction API allows for registering a check.