Creating a Monitoring Platform Agent
You can monitor logs and processes with Redwood Server by using checks in process servers. Monitoring process servers are platform agents that monitor processes, logs, or sockets. A monitoring process server cannot process jobs or handle file events.
note
This topic covers on-site environments, for SaaS, see Install SaaS Platform Agents.
Procedure
Create a Monitoring Agent with the Wizard
- Navigate to "Environment > Process Servers".
- Select Monitoring ONly and choose Next.
- Fill in the hostname of the monitored system as well as a port; choose Next.
- Specify a name for the process server, select a time zone and the appropriate installer for your platform; choose Next.
- Choose the matching installer.
- Download the installer to the server you want to monitor and execute the binary as an administrative user (Administrator or root).
- Start the new service or daemon on your server.
- Back in the wizard, choose Next and verify that the process server is running in Redwood Server.
- If the process server remains in status Connecting, check the operator messages and logs on the monitored server.
- Choose Save & Close.
Create a Monitoring Agent Manually
- Navigate to "Configuration > Software".
- Download the appropriate installer for your platform.
- Install the process server on the server you want to monitor, do not register the platform agent with the central Redwood Server. If possible, use the default values, you must remember the port for later. Copy the SharedSecret String to a temporary location.
- In Redwood Server, navigate to "Environment > Process Servers".
- Choose New Process Server from the context-menu, select Manual Setup.
- On the Services tab, select PlatformAgentService.
- On the Parameters tab, choose Add, fill
RemoteHostName
into the Name field, a fully qualified domain name into the value field. - Choose Add and fill
SharedSecret
into the Name field, paste theSharedSecret
String from the installation into the value field. - If you could not use port
1555
during the installation, choose Add, fillRemotePort
into the name field and fill the port you specified during installation into the Value field. - Choose Save & Close.
Example
Installation on GNU/Linux
- Navigate to "Configuration > Software".
- Download the
linux-x86.bin
installer. - Install the process server on the server you want to monitor.
- Enter
1
for English and hit the Return key on your keyboard. - Hit the Return key to install the platform agent to
/opt/redwood/agent
. - Hit the Return key to create the directory, if asked to.
- Hit the Return key to accept default as the name for your platform agent instance.
- The installer will detect an IP port to use for the platform agent, starting at
1555
, hit the Return key to accept the port, write it down if it is not1555
. - Hit the Return key to accept user
nobody
for jobs, since you are not going to schedule jobs on this system with this platform agent. - Hit the Return key to accept
setuid
as the default user switching method. Note that this will not be used. - Enter N as you do not want to register the platform agent.
- Hit the Return key to have the platform agent start automatically when the system starts.
- Hit the Return key to accept that the platform agent is updated automatically.
Configure the Process Server inside Redwood Server
- In Redwood Server, navigate to "Environment > Process Servers".
- Choose New Process Server from the context-menu, select Manual Setup.
- On the Services tab, select PlatformAgentService.
- On the Parameters tab, choose Add, fill RemoteHostName into the Name field, a fully qualified domain name into the value field.
- If you could not use port
1555
during the installation, choose Add, fill RemotePort into the name field and fill the port you specified during installation into the Value field. - Choose Save & Close.
See Also
- Monitoring System Performance
- Monitoring Servers with Platform Process Servers
- Monitoring External Systems with Platform Agents
- Creating Custom Monitor Checks
onsiteTopic