Feedback
62c62344-a15e-404b-8057-48e5ae7eb9a9
Custom Page Deployment Manager has not updated its status recently
Description
This alert is triggered when at least one Custom Page Deployment Manager agent has not updated for 3 or more minutes. Normally, the "kCura Web Processing Manager" Windows service will periodically update these agents. These updates consist of:
- Checking if the agent has been deleted
- Setting the enabled status, logging level, and interval
- Updating the Agents table in the EDDS database
- Replacing the currently running agent if a new version has been uploaded to Relativity.
If the alert is active, then these updates have not taken place within the last 3 minutes and the agent may be the wrong version or have the wrong settings.
Resolution Guidance
Impact When Active
- Custom page or application updates may not properly propagate to all Web Servers.
- Users may experience outdated or missing custom pages when interacting with the application.
- The issue may persist until the affected Custom Page Deployment Manager agent is restored to a healthy state.
How To Resolve
- In Kibana, navigate to the
[Relativity] Custom Page Deployment Managers without recent updates savedsearch. - Identify the agents that have not updated recently.
- In Relativity:
- Go to the Agents tab.
- Locate each Custom Page Deployment Manager agent.
- Check if the Enabled column has a value of No.
- Enable any agents with
Enabled = No.
- If agents do not update after being enabled:
- Open the
[Relativity] Windows Servicesdashboard in Kibana - Look for any entries for
kCura EDDS Web Processing Managerwhere Is Service Running is No.
- Open the
- For each affected Web Server:
- Log into the server.
- Open the Windows Services control panel.
- Locate and start the
kCura EDDS Web Processing Managerservice if it is not already running
Alert Details
Alert Condition Details
| Name | Value | Description |
|---|---|---|
| Rule Type | Elastic query | Checks for the relsvr.agent.updating metric |
| Data View | metrics-* | |
| Filter Query | relsvr.agent.updating: 0 and labels.relsvr_agent_type_guid: BC5A8102-C038-432E-B3A7-C34C86412996 | |
| Group | Count | Total number of custom page deployment manager agents with relsvr.agent.updating = 0 |
| Threshold | > 0 | |
| Time Window | Last 1 minute | |
| Frequency | Every 3 minutes |
Alert Metric Details
Metric Name: relsvr.agent.updating
Metric Description: Whether the agent has updated in the last 3 minutes
Metric Attributes:
| Attribute Name | Description | Value |
|---|---|---|
| labels.application_name | Application Name | Name of the Relativity application the agent comes from or Environment Administration & Operations for default applications |
| labels.name | Name of the metric | |
| labels.relsvr_system | System Name | Agents |
| labels.relsvr_subsystem | Subsystem Name | |
| labels.relsvr_agent_name | Name of the agent that is not updating | |
| labels.message | A string containing the server name, agent name, time of the last update from the agent, whether the agent is enabled, and the agent run interval | |
| labels.relsvr_server_name | The name of the Web Background Processing server | |
| labels.relsvr_server_state | Whether the resource server is active | |
| labels.relsvr_agent_status | The current status of the agent | Not updating |
| labels.relsvr_agent_type_name | The name of the agent type of the stale agent | |
| labels.relsvr_agent_type_guid | The GUID of the agent type of the stale agent |
