Service Discovery

Managing service discovery

⚠️

Chronosphere Internal

Don't share this information with customers. Any features or processes described here are meant for Chronosphere internal use only.

Chronosphere provides a view into your applications based on services (opens in a new tab). If a service doesn't match what you expect, or there are panel groups missing from a service, you can edit the service configuration in Chronosphere to include any missing items.

To edit a service configuration, in the navigation menu select Managing > Service configuration.

Understand service configuration

The Service configuration page displays information about which services have data, and how Chronosphere maps the data together.

Service pod mapping

The initial Chronosphere service discovery maps services to pod instances (opens in a new tab). Pod instances usually have labels explaining what they do, and what service they belong to. Chronosphere uses those labels to match the physical pods to a discovered service.

  • Slug: The slug name of the discovery rule defining the service pod mapping.
  • Name: The rule name. Click the name to open Metrics Explorer (opens in a new tab), pre-populated with the query created by this rule.
  • Service labels: One or more labels containing information about the service name.
  • Pod label: This label usually contains information about the pod or instance. The pod label is used as a key to map to the service name.

Component overrides

Create overrides for components that identify metrics for a discovered service.

Available edits to component details include:

  • Component name: A name describing what the component found.
  • Component query: The query used to create the component.
  • Target name: The metric label containing the service name.
  • Target regex: The regular expression used to search for a label value.

Focus your component using one of the following groups:

  • Service mapping: Use a Service label filter the component to only that service label.

  • Instance mapping:

    • Instance label: This label usually contains information about the instance or pod. Label values are used as keys to map to the service name.
    • Transform regex: This regular expression allows modification of the value in the instance label to match a value in the service instance mappings.
    • Transform replacement: This regular expression is replacing the original label, allowing modification of the value in the instance label so that it matches a value in the service instance mappings.
    • Identifying label: This label contains information that uniquely identifies which service the time series belongs to.

To edit a component override:

  1. Click the 3 vertical dots icon.
  2. Select Edit config.
  3. Update one set of the following fields:
    • Object label:
    • Unique label: and Pod label: Component name and Component query can't be edited.
  4. Click Save.

Click the open in new window icon to open the query in Metrics Explorer.

Service rules

When a service doesn't match expectations, create service rules to correct them.

Use the Search rules box to find a specific rule.

Create a service rule

To create a service rule:

  1. Click + Create.
  2. Add the following fields:
    • Rule Description: Describe what this service rule does. Displays on configuration page as Description.
    • Merge action: Displays on configuration page as Type. Select a rule type:
      • Merge rules group services together.
      • Hide rules remove them from the interface display, and stop collecting data.
      • Keep rules keep only the selected data, and discard all other data.
        ⚠️

        Data discarded by a keep rule isn't recoverable.

    • Source labels: Specify which label's values the rules apply to.
    • Regex: Add a new regular expression to replace the original. On the service configuration page, the original Regex displays, along with the Replacement, which is the value added here.
  3. Click Save. The Service configuration page displays, with your updates displayed.
  4. Click Preview and apply.
  5. The Service changes preview screen displays. Preview your changes using the table. The Service and the Metric components included in that service show what metrics are merged into a given service name. Services and metrics being removed from display have a [-] before them.
  6. Click Apply changes when finished.

Edit or delete a service rule

To edit or delete a service rule:

  1. Click the 3 vertical dots.
  2. Click Edit rule to change the rule, or Delete to remove the rule.
  3. Edit the fields, per their descriptions in the create rules section.
  4. Click Save.

Rule order

Service rules apply from the top to the bottom of the list. A service matches the first rule applying to it, and won't match additional rules. Use the grab handle to move the rule up or down in the list to change the order of rule application.