Wednesday, April 12, 2017

Oracle Management Cloud – Setup Entities in Log Analytics

In order to gather Weblogic’s Admin Server and Managed Server log files, you need first to install and configure the OMC Cloud Agent.  


Then you need to verify that the Cloud Agent is up and running.  Refer to my previous post on how to manage the Cloud Agent.


The next step is to setup the Log Analytics entities. In order to do this you have to make use of a JSON template. Oracle provides examples of these templates in the OMC documentation:


In this example we are going to add a Weblogic Admin Server and Managed server as Cloud Agent entities.

Unzip the example zip file and modify the omc_weblogic_domain_credless.json file.

The data added to this file really depends on your environment. This is how it looks for my environment:

{
   "entities":[
      {
         "name":"base_domain",
         "type":"omc_weblogic_domain",
         "displayName":"Weblogic_on_<servername>",
         "timezoneRegion":"PST",
         "properties":{
            "port":{
               "displayName":"Port",
               "value":"7001"
            },
            "domain_home":{
               "displayName":"Domain Home",
               "value":"/u01/app/oracle/product/ofm12.1.2/user_projects/domains/base_domain"
            },
            "admin_server_host":{
               "displayName":"AdminServer",
               "value":"<servername>.<domainname>"
            },
            "webLogic_home":{
               "displayName":"WebLogic Home",
               "value":"/u01/app/oracle/product/ofm12.1.2/wlserver"
            }
         },
         "associations":[
            {
               "assocType":"omc_contains",
               "sourceEntityName":"base_domain",
               "sourceEntityType":"omc_weblogic_domain",
               "destEntityName":" <servername>__AdminServer",
               "destEntityType":"omc_weblogic_j2eeserver"
            }
         ]
      },
      {
         "name":"<servername>_AdminServer",
         "type":"omc_weblogic_j2eeserver",
         "displayName":"AdminServer_<servername>",
         "timezoneRegion":"PST",
         "properties":{
            "host_name":{
               "displayName":"Weblogic Host",
               "value":"<servername>.<domainname>"
            },
            "domain_home":{
               "displayName":"Domain Home",
               "value":"/u01/app/oracle/product/ofm12.1.2/user_projects/domains/base_domain"
            },
            "listen_port":{
               "displayName":"Listen Port",
               "value":"7001"
            },
            "listen_port_enabled":{
               "displayName":"Listen Port Enabled",
               "value":"true"
            },
            "ssl_listen_port":{
               "displayName":"SSL Listen Port",
               "value":"7002"
            },
            "server_names":{
               "displayName":"Server Names",
               "value":"AdminServer"
            }
         },
         "associations":[
            {
               "assocType":"omc_monitored_by",
               "sourceEntityName":"<servername>_AdminServer",
               "sourceEntityType":"omc_weblogic_j2eeserver",
               "destEntityName":"base_domain",
               "destEntityType":"omc_weblogic_domain"
            }
         ]
      },
      {
         "name":"<servername>_ManagedServer_1",
         "type":"omc_weblogic_j2eeserver",
         "displayName":"ManagedServer_1_<servername>",
         "timezoneRegion":"PST",
         "properties":{
            "host_name":{
               "displayName":"Weblogic Host",
               "value":"<servername>.<domainname>"
            },
            "domain_home":{
               "displayName":"Domain Home",
               "value":"/u01/app/oracle/product/ofm12.1.2/user_projects/domains/base_domain"
            },
            "listen_port":{
               "displayName":"Listen Port",
               "value":"7003"
            },
            "listen_port_enabled":{
               "displayName":"Listen Port Enabled",
               "value":"true"
            },
            "ssl_listen_port":{
               "displayName":"SSL Listen Port",
               "value":"7005"
            },
            "server_names":{
               "displayName":"Server Names",
               "value":"ManagedServer_1"
            }
         },
         "associations":[
            {
               "assocType":"omc_monitored_by",
               "sourceEntityName":"<servername>_ManagedServer_1",
               "sourceEntityType":"omc_weblogic_j2eeserver",
               "destEntityName":"base_domain",
               "destEntityType":"omc_weblogic_domain"
            }
         ]
      }
   ]
}

Save this file and load the entities to the Cloud Agent as follows:

$ ./omcli add_entity agent /home/oracle/omc_weblogic.json
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
Operation Succeeded: Accepted 3 of 3 entities for processing.

As you can see, 3 entities were loaded to the agent; the base_domain, Admin Server and Managed Server.


Now verify the new entities in the Log Analytics configuration page.
-        Click on the “Navigation” icon.
-        Under “Cloud Services” click on “Log Analytics”



Click on “Configuration” located in the right side of the screen






In the “Entities” section. Click on the icon with the number (ie. 4)





You will see a list of the new entities just added.
Go back to “Log Explorer” by clicking on







In the search box type ‘Log Source’ = ‘FMW WLS Server Logs’






Click on “Run”





Check all the log information displayed for the WLS Server



Saturday, April 1, 2017

Oracle Management Cloud - Managing the Oracle Cloud Agent

This post is about some useful commands to administer the OMC’s Cloud agent. The very first step is to install the OMC Cloud agent. You may refer to my previous post on how to install it here.

The omcli command is located at <AGENT_BASE_DIR>/agent_inst/bin.

I’m skipping these 3 basic commands start, stop and status.

Here we go!

-      List the targets currently managed by the Cloud agent

$ ./omcli config agent listtargets
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
[hostname.localdomain:1302, Lama]
[hostname.localdomain, omc_host_linux]

-      Get the TimeZone of the server where the Cloud agent is running

$ ./omcli config agent getTZ
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
US/Eastern

-      Get a detailed output of the Cloud agent scheduler

$ ./omcli status agent scheduler
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Number of currently running scheduled items :: 0
Number of currently ready scheduled items :: 0
Number of scheduled items :: 57
Schedule Attempts Delay Percentage :: 0.000%
Running entries::
Ready entries::
Scheduled entries::
2017-03-31 14:32:58.968 : HeapMonitorTask
2017-03-31 22:34:14.667 : PurgeTargetEvents
2017-03-31 22:35:47.885 : PurgeADR
2017-04-01 13:34:20.810 : EventStatusPurge

---------------------------------------------------------------
Agent is Running and Ready

-      Get a summary of the Cloud agent’s scheduler

$ ./omcli status agent scheduler -summary
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Number of currently running scheduled items :: 0
Number of currently ready scheduled items :: 0
Number of scheduled items :: 57
Schedule Attempts Delay Percentage :: 0.000%

---------------------------------------------------------------
Agent is Running and Ready

-      Dump the internal state of the agent [option component name]

$ ./omcli dumpstate agent
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
Generated file: /u01/omc/infra/agent_inst/sysman/emd/dumps/SystemDump_1490985620656.xml

-      Dump internal information of all components of the Cloud agent

$ ./omcli dumpstate agent -dump_full_state
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
Generated file: /u01/omc/infra/agent_inst/sysman/emd/dumps/SystemDump_1490985775823.xml

-      Add entities to the Cloud agent using JSON template

$ ./omcli add_entity agent /home/oracle/omc_weblogic.json
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
Operation Succeeded: Accepted 2 of 2 entities for processing.

-      Delete entities from the Cloud agent using JSON template

$ ./omcli delete_entity agent /home/oracle/omc_weblogic.json
Oracle Management Cloud Agent 
Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.
Request for removing the entities was accepted for processing.



This is just a small taste of all the options built into the Oracle’s Cloud agent.  For more information about all the options refer to Oracle’s documentation.


Thanks,

Alfredo