OEM 13C Useful EMCTL Agent Commands

Here’s a list of some useful emctl commands to manage your OEM 13c agent.

Get the status of the agent:

$ emctl status agent

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

---------------------------------------------------------------

Agent Version          : 13.2.0.0.0

OMS Version            : 13.2.0.0.0

Protocol Version       : 12.1.0.1.0

...

Last Reload            : (none)

Last successful upload                       : 2018-05-15 09:04:32

Last attempted upload                        : 2018-05-18 13:12:29

Total Megabytes of XML files uploaded so far : 13.6

Number of XML files pending upload           : 1,956

Size of XML files pending upload(MB)         : 3.64

Available disk space on upload filesystem    : 81.90%

Collection Status                            : Collections enabled

Heartbeat Status                             : OMS is unreachable [not running]

Last attempted heartbeat to OMS              : 2018-05-18 13:12:02

Last successful heartbeat to OMS             : 2018-05-15 09:10:00

Next scheduled heartbeat to OMS              : 2018-05-18 13:12:44

---------------------------------------------------------------

Agent is Running and Ready

Get the list of targets currently monitored by the agent:

$ emctl config agent listtargets

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

[localhost.localdomain.com, host]

[localhost.localdomain.com:3872, oracle_emd]

[Management Services and Repository, oracle_emrep]

...

[/EMGC_GCDomain/GCDomain/EMGC_OMS1, weblogic_j2eeserver]

[NodeManager_localhost.localdomain.com_1, weblogic_nodemanager]

[oms13c1_1_localhost.localdomain.com_4754, oracle_home]

Get the status of a particular target:

$ emctl status agent target /EMGC_GCDomain/GCDomain/EMGC_OMS1,weblogic_j2eeserver

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

---------------------------------------------------------------

Target Name : /EMGC_GCDomain/GCDomain/EMGC_OMS1

Target Type : weblogic_j2eeserver

Current severity state

----------------------

Metric        Column name             Key             State           Timestamp

--------------------------------------------------------------------------------

Response      Status                  n/a             CRITICAL        Fri May 18 13:13:25 EDT 2018

alertLogAdrIncident adr_problemKey          Fri Jun 23 16:07:21 2017/254 CRITICAL        Fri Jun 23 16:07:58 EDT 2017

alertLogAdrIncident adr_problemKey          Fri Jun 23 16:08:10 2017/263 CRITICAL        Fri Jun 23 16:12:58 EDT 2017

alertLogAdrIncident adr_problemKey          Mon Jul 10 06:06:34 2017/290 CRITICAL        Mon Jul 10 06:08:52 EDT 2017

alertLogAdrIncident adr_problemKey          Mon Jun 26 13:04:51 2017/272 CRITICAL        Mon Jun 26 13:08:48 EDT 2017

alertLogAdrIncident adr_problemKey          Tue Jun 27 17:50:54 2017/281 CRITICAL        Tue Jun 27 17:53:48 EDT 2017

jvm           heapUsedPercentage.value n/a             CLEAR           Tue May 15 09:07:27 EDT 2018

jvm_threads   deadlockedThreadCount.value n/a             CLEAR           Tue May 15 09:06:15 EDT 2018

---------------------------------------------------------------

Agent is Running and Ready

Clear the current status of a target’s metrics:

$ emctl clearstate agent /EMGC_GCDomain/GCDomain/EMGC_OMS1,weblogic_j2eeserver

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

Clear target severity state

Now they show as undefined until the next collection happens:

$ emctl status agent target /EMGC_GCDomain/GCDomain/EMGC_OMS1,weblogic_j2eeserver

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

---------------------------------------------------------------

Target Name : /EMGC_GCDomain/GCDomain/EMGC_OMS1

Target Type : weblogic_j2eeserver

Current severity state

----------------------

Metric        Column name             Key             State           Timestamp

--------------------------------------------------------------------------------

Response      Status                  n/a             UNDEFINED       Fri May 18 13:14:25 EDT 2018

alertLogAdrIncident adr_problemKey          Fri Jun 23 16:07:21 2017/254 UNDEFINED       Fri Jun 23 16:07:58 EDT 2017

alertLogAdrIncident adr_problemKey          Fri Jun 23 16:08:10 2017/263 UNDEFINED       Fri Jun 23 16:12:58 EDT 2017

alertLogAdrIncident adr_problemKey          Mon Jul 10 06:06:34 2017/290 UNDEFINED       Mon Jul 10 06:08:52 EDT 2017

alertLogAdrIncident adr_problemKey          Mon Jun 26 13:04:51 2017/272 UNDEFINED       Mon Jun 26 13:08:48 EDT 2017

alertLogAdrIncident adr_problemKey          Tue Jun 27 17:50:54 2017/281 UNDEFINED       Tue Jun 27 17:53:48 EDT 2017

jvm           heapUsedPercentage.value n/a             UNDEFINED       Tue May 15 09:07:27 EDT 2018

jvm_threads   deadlockedThreadCount.value n/a             UNDEFINED       Tue May 15 09:06:15 EDT 2018

---------------------------------------------------------------

Agent is Running and Ready

Force the agent to collect dynamic properties:

$ emctl reload agent dynamicproperties /EMGC_GCDomain/GCDomain/EMGC_OMS1:weblogic_j2eeserver

Oracle Enterprise Manager Cloud Control 13c Release 2

Copyright (c) 1996, 2016 Oracle Corporation.  All rights reserved.

---------------------------------------------------------------

EMD recompute dynprops completed successfully

Thanks,

Alfredo