Feedback
034d0230-bd3b-4c50-b17d-7b7fdd85ccd0
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
- Click on the Alert link in Relativity to go to the Kibana search named
[Relativity] Required Agents that do not exist - The Kibana search identifies the Agent Type of the missing agents.
- 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
0indicates that the Agent does not exist. - A value of
1indicates 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 |
