# Plugin weblogic

# Introduction

**Ver**. 07-09-2021  
  
Plugin that collects stats from each server and app in the installation, also collects data from threadpools, jvm and agent snmp.

<div id="bkmrk-tipo%3A-server-plugin"><div>**Tipo**: Server plugin</div></div>

# Compatibility

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 56px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it has been tested**</td><td style="width: 50%; height: 28px;">CentOS 7, Fedora

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Systems where it should work**</td><td style="width: 50%; height: 28px;">Any linux system

</td></tr></tbody></table>

# Prerequisites

Required:

- A Weblogic server
- To have RESTful Management Services enabled in weblogic
- Pandora FMS Data Server enabled.
- Pandora FMS Plugin Server enabled.

# Configuration

To use the plugin you need to have RESTful Management Services activated on your weblogic server, to do this go to :

Domain -&gt; Configuration -&gt; General -&gt; Advanced -&gt; Enable RESTful Management Services

And restart the Admin Server.

[![image-1631097652682.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/image-1631097652682.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/image-1631097652682.png)

# Plugin general parameters

```
python pandora_weblogic.py -u <ip-with-port> -us <user> -p <password>
```

If the execution is correct we will see a 1.

# Parameters specifics

The plugin has the following parameters:

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 174px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">**Parámetro**</td><td style="width: 50%; height: 29px;">**Descripción**</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">-u &lt;url-with-port&gt; --ip &lt;url-with-port&gt;url</td><td style="width: 50%; height: 29px;">with the port, mandatory.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">-us &lt;user&gt; --user &lt;user&gt;</td><td style="width: 50%; height: 29px;">weblogic user, required.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">-p &lt;password&gt; --password &lt;password&gt;</td><td style="width: 50%; height: 29px;">password weblogic, required.</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">-g GROUP, --group GROUP</td><td style="width: 50%; height: 29px;">Pandora FMS target group (optional)</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">--data\_dir DATA\_DIR</td><td style="width: 50%; height: 29px;">Pandora FMS data directory. By default it is /var/spool/pandora/data\_in/ (optional)</td></tr></tbody></table>

# Configuration in pandora

**Installation from the console**

To register the plugin, from the console, go to the "register plugin" section.

**[![register_plugin.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register-plugin.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register-plugin.png)**

Click on select file.

**[![register_plugin2.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register-plugin2.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register-plugin2.png)**

Select the pspz2 file containing the plugin.

[![register1_weblogic.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register1-weblogic.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register1-weblogic.png)

A message that it has been successfully installed will be displayed.

[![register2_weblogic.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register2-weblogic.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register2-weblogic.png)

Once the plugin is registered, we will see it in the plugins section.

[![serversingles.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/serversingles.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/serversingles.png)

In the parameters section, all the parameters contained in the plugin will appear and can be configured, remember that not all of them are mandatory, only those that are specified.

[![register3_weblogic.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register3-weblogic.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register3-weblogic.png)

Below you can assign a value to each macro.

[![register4_weblogic.png](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/scaled-1680-/register4-weblogic.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2022-04/register4-weblogic.png)

The best way to manage server plugins in Pandora is from "/usr/share/pandora\_server/util/plugin" so we will send it to that path.

Then we will move to the folder where we have put it ("/usr/share/pandora\_server/util/plugin" is the recommended one").

We move from home with :

<div id="bkmrk--6"></div>```
cd /usr/share/pandora_server/util/plugin/
```

We run the plugin to see that it works:

```
python pandora_weblogic.py -u <ip-with-port> -us <user> -p <password>
```

**As a server plugin**

Go to servers &gt; plugins:

[![image-1629974405286.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974405286.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974405286.png)

Click in add:

[![image-1629974430627.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/scaled-1680-/image-1629974430627.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-08/image-1629974430627.png)

We put in the name and description of your choice:

[![weblogic1.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/weblogic1.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/weblogic1.png)

We enter as command the path to the plugin, and as parameters the ones we have entered by executing the plugin, the "\_field\_" fields are macros defined below.

[![weblogic2.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/weblogic2.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/weblogic2.png)

We put for each macro the description that you prefer and as value the data of your url, user and pass.

[![weblogic3.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/weblogic3.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/weblogic3.png)

Once this is done, if we execute the plugin from the terminal, the agent with the modules will have been created.

# Modules generated

An agent will be created for each server and application of our Weblogic, with modules with their stats, and an agent with JVM data, threadpools and agent snmp.

**Modules Server**

<table border="1" id="bkmrk-cluster-name-current" style="border-collapse: collapse; width: 100%; height: 174px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px;">cluster name</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">current machine</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">health</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">heapFreeCurrent</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">heapSizeCurrent</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">heapSizeMax</td></tr></tbody></table>

<table border="1" id="bkmrk-java-version-opensoc" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">java version</td></tr><tr><td style="width: 100%;">OpenSocketsCurrentCount</td></tr><tr><td style="width: 100%;">oSname</td></tr><tr><td style="width: 100%;">oSversion</td></tr><tr><td style="width: 100%;">state</td></tr><tr><td style="width: 100%;">weblogic version</td></tr></tbody></table>

**Modules Aplication**

<table border="1" id="bkmrk-completedrequest-pen" style="border-collapse: collapse; width: 100%; height: 145px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px;">completedRequest</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">pendingRequest</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">health</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">state</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">type</td></tr></tbody></table>

**Modules Snmp agent,jvm y threadpools**

<table border="1" id="bkmrk-jvmruntime.-jvmrunti" style="border-collapse: collapse; width: 100%; height: 290px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.heapfreecurrent</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.heapfreepercent</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.heapsizecurrent</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.heapsizemax</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.javavendor</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.javaversion</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.javavmvendor</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.name</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.osname</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.osversion</td></tr></tbody></table>

<table border="1" id="bkmrk-jvmruntime.-jvmrunti-0" style="border-collapse: collapse; width: 100%; height: 290px;"><tbody><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.processcpuload</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">JVMRuntime.uptime</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.attributechangetrapcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.countermonitortrapcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.failedauthenticationcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.failedauthorizacioncount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.failedencrytioncount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.gaugemonitortrapcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.logmessagetrapcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">SNMPAgentRunTime.masteragentxport</td></tr></tbody></table>

<table border="1" id="bkmrk-snmpagentruntime.-sn" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 100%;">SNMPAgentRunTime.monitortrapcount</td></tr><tr><td style="width: 100%;">SNMPAgentRunTime.serverstarttrapcount</td></tr><tr><td style="width: 100%;">SNMPAgentRunTime.serverstoptrapcount</td></tr><tr><td style="width: 100%;">SNMPAgentRunTime.stringmonitortrapcount</td></tr><tr><td style="width: 100%;">SNMPAgentRunTime.udplistenport</td></tr><tr><td style="width: 100%;">ThreadpoolRunTime.executecompletedrequestcount</td></tr><tr><td style="width: 100%;">ThreadpoolRunTime.executethreadidlecount</td></tr><tr><td style="width: 100%;">ThreadpoolRunTime.executetotalthreadcount</td></tr><tr><td style="width: 100%;">ThreadpoolRunTime.hoggingthreadcount</td></tr><tr><td style="width: 100%;">ThreadpoolRunTime.minthreadsconstraintcompleted</td></tr></tbody></table>

<table border="1" id="bkmrk-threadpoolruntime.-t" style="border-collapse: collapse; width: 100%; height: 227px;"><tbody><tr style="height: 24px;"><td style="width: 100%; height: 24px;">ThreadpoolRunTime.minthreadsconstraintpending</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.overloadrejectrequests</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.pendinguserrequestcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.queuelenght</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.sharedcapacityforworkmanager</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.standbythreadcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.stuckthreadcount</td></tr><tr style="height: 29px;"><td style="width: 100%; height: 29px;">ThreadpoolRunTime.throughtput</td></tr></tbody></table>

[![modulos1.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/modulos1.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/modulos1.png)

[![modulos2.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/scaled-1680-/modulos2.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-09/modulos2.png)