Deliver Records Using an Agent

To upload logs, events, and metrics to the Monitoring service, you can use either a monitoring agent or the SDK. If you choose to use a monitoring agent, you must first install the agent.

The monitoring agent reads the logs/events/metrics from a folder(s) you specify as the source and uploads the log/event/metric entries to a remote server. As more records are added, the agent adds new log/event/metric entries to the server where they are stored in a searchable format.

Since the Cloud Monitoring service only accepts records in the JSON format, you have to configure your system to report logs, events, and metrics in the JSON format or use a third-party JSON converter. You can edit the configuration file to convert logs, events, and metrics to the JSON format.

To install the Monitoring Agent:

  1. Download and double-click the MonitoringAgent.msi file. The Edifecs Monitoring Agent Setup Wizard opens.
  2. Click Next.
  3. Review and accept the license agreement, and then click Next.
  4. Click Change to specify the folder where you want the Edifecs Monitoring Agent installed, or click Next to accept the default location.
  5. Select the JRE/JDK from the installed JRE/JDK versions, or enter a path to a JRE/JDK folder with binaries.

    6. Note The required JRE/JDK version is 8u162 or later.

  6. Select the Java heap size, and then click Next.
  7. On the Monitoring Agent Configuration page, navigate to the application credentials file in your file system. For instructions on how to download the credentials file, click here.
  8. In Source name, enter a name for the system whose logs, events, and metrics you plan to upload to the Cloud Monitoring service. Follow these naming rules:
    • Use lowercase
    • Do not use . or .. characters
    • Do not start the name with the _, - or + characters
    • Do not use #, \, /, *, ?, ", <, >, |, and white space characters.
  9. Click Next.
  10. Navigate to the source folder where the logs/events/metrics reside. Clear Include subfolders if you do not want the agent to read the files located in the subfolders.
  11. Select a file mask (to match the files) if you want to specify which file formats to read, and then click Next.
  12. Click Install to initiate the installation process.
  13. When the installation is complete, click Finish. You can view the log records on the Logs page and event records on the Events page, and visualize metrics on the Dashboards page of the Monitoring service.

The Monitoring agent allows you to upload logs, events, and metrics from one single source. To configure multi-source uploads, use the SDK.

If you want to change the source configuration (for example, the source name or the path to a source folder), you must restart the Monitoring Agent installer with the Modify option and provide a new configuration.