Enable Host Monitoring

Your hosts are automatically added as entities when a Cloud agent is installed. Monitoring of host entities, however, is disabled by default.

You can enable host monitoring directly from the Oracle Management Cloud console. Depending on the type of licensing, you may or may not see a Licensing option, so the procedures will differ.

To determine whether the Licensing option is available, from the Oracle Management Cloud console navigation pane, select Administration –>Entity Configuration

Versions with the Licensing Option

  1. Click Licensing.

  2. Click Select Entities and choose the desired host.

  3. Select Standard Edition or Enterprise Edition.

  4. Click Save.

Versions without the Licensing Option

  1. Click Enable/Disable Services.

  2. Click Select Entities. The Select Entities dialog displays.

  3. Select the desired host target from the list and click Select to close the dialog. The host appears in the Entity list. Ensure that Monitoring has been enabled for the entity.

  4. If the Monitoring service is not already enabled, click Enable Services. The Enable Services dialog displays.

  5. Toggle the Monitoring service on and click Enable Services.

If you want to enable host monitoring using the command line interface (OMCLI) and JSON files, the capability property must be set to monitoring as shown in the following procedure.

  1. Edit the sample Host JSON file provided with the appropriate values for your hosts.

    The sample JSON file you downloaded (update_host_sample_1.14_and_on.json)

    • name: Your local host name used for your Cloud Agent installation.

    • type: Your host type. The options are:

      • omc_host_linux

      • omc_host_solaris

      • omc_host_windows

      • omc_host_aix

    The best way to determine the correct values of the entity name and type is to query the agent on your host. For example, run the following:
     ./omcli status_entity agent
    Oracle Management Cloud Agent  
    Copyright (c) 1996, 2018 Oracle Corporation.  All rights reserved.
          Lama.host1.example.com:3872        : AGENT:entity successfully added
          omc_host_linux.host1.example.com   : AGENT:entity successfully added
    In this case, your JSON file will become:
    {
    	"entities":
    		[
    			{
    				"name": "host1.example.com",
    				"type": "omc_host_linux",
    				"properties":{
    					"capability": {
    					"displayName": "capability",
    					"value": "monitoring"
    				}
    
    			}
    		}
    	]
    }		
  2. Update your host entity. From the agent installation directory (for example, on a UNIX system, <AGENT_BASE_DIR>/agent_inst/bin) run:

    ./omcli update_entity agent <Your Host JSON input file name>.json

    For example,
    ./omcli update_entity agent update_host_host1.json
If you have an HA configuration (a virtual host with two or more physical hosts configured with failover software) note the following:
  • Your Cloud agents must be installed on all hosts (virtual and physical hosts).

  • The Cloud agents on your physical hosts will monitor the host entities. Therefore, the steps listed above to enable host monitoring must be performed on the physical hosts.

  • The other entities you want monitored must be added using the Cloud agent on the virtual host.