# Service Discovery

> A mechanism that resolves a service name to a healthy network endpoint at call time through a registry.

Record: `architecture:service-discovery`
Kind: mechanism
Layer: [Extensibility Core](https://banes-lab.com/records/layer/extensibility-core.md)
Severity: contextual
Scope: service, network, runtime
Canonical: https://banes-lab.com/ontology#architecture-service-discovery

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Runtime Discovery](https://banes-lab.com/records/architecture/runtime-discovery.md) and before [Dynamic Binding](https://banes-lab.com/records/architecture/dynamic-binding.md).

## Repair

- Refactored by: Introduce Discovery Client, Externalize Endpoint
- Detected by: hardcoded URLs, missing registry lookup
- Violated by: fixed service addresses in code
- Measured by: dynamic resolution coverage
- Enforced by: config scans, deployment policy

## Requires

- [Service Registry](https://banes-lab.com/records/architecture/service-registry.md)
- [Health Checks](https://banes-lab.com/records/architecture/health-checks.md)

## Reinforces

- [Scalability](https://banes-lab.com/records/architecture/scalability.md)
- [Resilience](https://banes-lab.com/records/architecture/resilience.md)

## Enables

- [Dynamic Routing](https://banes-lab.com/records/lexicon/dynamic-routing.md)
- [Failover](https://banes-lab.com/records/architecture/failover.md)

## Conflicts with

- [Hardcoded Endpoints](https://banes-lab.com/records/lexicon/hardcoded-endpoints.md)

## In tension with

- [Operational Complexity](https://banes-lab.com/records/lexicon/operational-complexity.md)

## Tensions

- [Service Discovery / Operational Complexity](https://banes-lab.com/records/tension/operational-complexity-service-discovery.md)

## Severity

- [contextual](https://banes-lab.com/records/vocabulary/severity-contextual.md)

## Category

- [Runtime Discovery / Dynamic Binding](https://banes-lab.com/records/architecture-category/runtime-discovery-dynamic-binding.md)

## Enabled by

- [Runtime Discovery](https://banes-lab.com/records/architecture/runtime-discovery.md)

## Linked from

- [Runtime Discovery / Dynamic Binding](https://banes-lab.com/ontology/principles/architecture-category-runtime-discovery-dynamic-binding.md)
- [Error Handling / Resilience](https://banes-lab.com/ontology/principles/architecture-category-error-handling-resilience.md)
- [Scalability / Performance / Optimization](https://banes-lab.com/ontology/principles/architecture-category-scalability-performance-optimization.md)
- [Plugin / Extensibility / IoC](https://banes-lab.com/ontology/principles/architecture-category-plugin-extensibility-ioc.md)
- [Self-Healing / Recovery / Deployment Safety](https://banes-lab.com/ontology/principles/architecture-category-self-healing-recovery-deployment-safety.md)
- [Core Vocabulary](https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md)
- [Runtime Discovery / Dynamic Binding](https://banes-lab.com/ontology/lexicon/lexicon-category-runtime-discovery-dynamic-binding.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)