One or more Required Agents does not exist

Description

This alert is triggered when there are no Agent instances for Agent Types that require at least one Agent.

Resolution Guidance

Impact When Active

  • Missing required agents lead to important workflow failures in Relativity.

    • Core Relativity operations performed by the missing Agent Type will not run.
    • Automated or background jobs that rely on the missing Agent Type may fail or may not be scheduled.
    • System health and performance may degrade depending on the role of the missing Agent Type.

How To Resolve

  1. Click on the Alert link in Relativity to go to the Kibana search named
    [Relativity] Required Agents that do not exist
  2. The Kibana search identifies the Agent Type of the missing agents.
  3. In Relativity, navigate to the Agents Tab. Then create a new Agent, of the identified Agent Type.

Alert Details

Alert Condition Details

Name Value Description
Rule Type Elastic Query Checks if a Required Agent is missing
Data View metrics-*
Filter Query relsvr.agent.exists : 0 and labels.relsvr_agent_required : 1 If the agent did not exist in the last 35 seconds
Group Count Number of Required Agents which did not exist
Threshold >= 1 If the count is greater than 0, alert triggers
Time Window Last 35 sec Verified data for last 35 seconds
Frequency 5 min Checks every 5 minutes

Alert Metric Details

Metric Name:relsvr.agent.exists

Metric Description: Whether the agent exists

  • A value of 0 indicates that the Agent does not exist.
  • A value of 1 indicates that at least one Agent does exist.

Metric Attributes:

Attribute Name Description Value
host.name Hostname of the affected Agent Server
labels.application_name Environment Administration & Operations
labels.name Name of the metric Required Agent does not exist
labels.relsvr_system System Name Agents
labels.relsvr_subsystem Subsystem Name The name of the Agent Type which is missing its Required Agent
labels.relsvr_agent_required Whether the agent is required Set to 1 to indicate that the agent is required
labels.relsvr_agent_type_name Agent Type Name The name of the Agent Type which is missing its Required Agent
labels.relsvr_agent_type_guid Agent Type Guid The guid of the Agent Type which is missing its Required Agent
labels.message Message describes the issue A sentence containing information about the Agent Type of the Required Agent that does or does not exist