Windows Resources Incorrectly Listed Under Linux OS Category

Issue:
After installing the OpsRamp Agent on a Windows machine, the resource is incorrectly displayed under the Linux OS category in the OpsRamp portal instead of Windows OS.

Reason:
This issue occurs when the OpsRamp Agent is installed on a Windows machine using an incorrect Agent Integration ID (InstalledAppId). When the wrong integration ID is used, the platform incorrectly maps the operating system and lists the Windows resource under the Linux OS category.

Solution:
To resolve the issue, follow these steps:

1. Uninstall the OpsRamp Agent from the affected Windows machine.
2. In the OpsRamp portal:
   • Navigate to Infrastructure → Search → Servers and VMs.
   • Select Linux OS to view the listed devices.
   • Locate the affected Windows device and mark it as Unmanaged.
   • Delete the unmanaged device from the list.
3. Reinstall the OpsRamp Agent on the Windows machine using the correct Agent Integration ID.
4. Verify that the resource now appears under the Windows OS category in the portal.

Graphs Not Displaying for Metrics Data

Issue:
Metrics data is being collected by the agent, but the graphs are not populating in the OpsRamp portal.

Reason:
This issue may arise due to discrepancies in the device’s time settings. If the device’s clock is set to a future or past time, the collected metric data might not be uploaded to the database properly, resulting in graphs not displaying on the portal.

Solution

1. Check Time Settings: Ensure the device’s time zone is set correctly according to its geographical location.
2. Synchronize with an NTP Server: Use a Network Time Protocol (NTP) server to automatically synchronize the device’s time with a standard reference clock. This helps ensure the time is accurate and consistent.
3. Manual Adjustment: If NTP synchronization is not available, manually adjust the time and date settings on the device.
4. Verify and Restart: After adjusting the time settings, verify that the device’s time is correct. Restart the device if necessary to ensure the changes take effect.

What to do when an agent is offline?

When installed/restarted an agent first performs a web post to api.opsramp.com on port 443 to get the server to connect.

1. Verify if DNS resolution is working.
2. Telnet to port 443 on api.opsramp.com.
3. In the browser, enter https://api.opsramp.com and verify the redirect to OpsRamp .

What if the agent cannot reach api.opsramp.com?

If api.opsramp.com is not reachable, the agent falls back to cn01-sjc.opsramp.com after six (6) checks to get the server URL to connect.

After getting the first response from api.opsramp.com, the agent connects to the servers based on which node the client is connected to. An agent log file is displayed and provides information about the agent connected to DNS.

How do I validate the agent if it is displayed offline?

1. Make sure DNS resolution is working.
2. Telnet to port 443 on above URLs based on what URL agent is connected to.
3. In the browser, type https://Above URL/stats. It displays a page with Agent count text.
4. If above validations are successful and agent remains offline, create a support ticket with the AgentLog file attached. Mention if the agent is a proxy agent or direct agent.

What are the steps that the agent shield uses for direct agent and proxy agent?

How to find the agent connection status directly from the host?

The inbuilt script in the agent will provide the agent’s online/offline status and a few other details.

Login to the Agent installed host and run the following command:

Here is the example output:

 {  
 "name": "DESKTOP-6CQTB02",
 "hostName": "DESKTOP-6CQTB02",
 "ipAddress": "192.168.43.232",
 "macAddress": "08:00:27:EC:8D:F9",
 "osName": "Microsoft Windows 10 Home 10.0.19042 Build 19042.1466",
 "osArchitecture": "64-bit",
 "agentInstalled": true,
 "agentStatus": "ONLINE",
 "agentLastConnectedTime": "2022-02-18T05:21:15"  
 }

Why did patch scan fail for Windows agent with “Missing Patch Scan Job failed” alert?

You may receive missing patch scan alert while scanning the Windows agent. To troubleshoot the “Missing Patch Scan Job failed” alert, follow below steps:

1. Open Alert Description: Open the alert description to access more information about the issue.
2. Examine Hexadecimal Error Code: Look for the hexadecimal error code provided in the alert description. These error codes are typically Microsoft-related.
3. Search the Error Code: Copy the hexadecimal error code (e.g., 0x80072ee2, 0x80080005) and perform a Google search. Refer to the documentation provided in the search results for more details about the error and possible solution.

How to Enable Container Discovery

Solution:

We have disabled the container discovery by default, users should have to pass -d false as an argument to the following configure command:

sudo /opt/opsramp/agent/bin/configure -K [Key] -S [Server] -s [API Key]