You are viewing docs for an older version of Linkerd. View the latest docs.
  • GitHub
  • Slack
  • Linkerd Forum

Service Profiles

Note

HTTPRoutes are the recommended method for getting per-route metrics, specifying timeouts, and specifying retries. Service profiles continue to be supported for backwards compatibility.

A service profile is a custom Kubernetes resource (CRD) that can provide Linkerd additional information about a service. In particular, it allows you to define a list of routes for the service. Each route uses a regular expression to define which paths should match that route. Defining a service profile enables Linkerd to report per-route metrics and also allows you to enable per-route features such as retries and timeouts.

Note

If working with headless services, service profiles cannot be retrieved. Linkerd reads service discovery information based off the target IP address, and if that happens to be a pod IP address then it cannot tell which service the pod belongs to.

To get started with service profiles you can: