Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Remove obscure references to 'panels'

...

Table of Contents

...

Table of Contents

...

This feature is in beta and can change at any time. This feature should be used in non production environments. In due course this will replace Business Services.

To enable Enterprise Services add this to opCommon.json and restart the omkd daemon.

Panel

"beta":{
      "opcharts_enterprise_services": "true"
   },
 
# execute these two commands:
sudo /usr/local/omk/bin/patch_config.exe /usr/local/omk/conf/opCommon.json /beta/opcharts_enterprise_services=true
sudo service omkd restart

Overview

Image Removed

Enterprise Services display interface status panels and node status panels in a single page.  This allows grouping related interfaces/nodes together to have a single location that a user can see these related items.

Enterprise Services are supported under the MSP authorization system when added as a dashboard component, RBAC for enterprise services is still being worked on.

How metrics are calculated

Nodes

...

Overview

opCharts enables you to build dynamic interactive charts and targeted custom dashboards for single-pane-of-glass views into your NMIS data. It increases your network visibility and accelerates root cause discovery by combining multiple data sets on its adaptable graphical interface.

You can create one such dashboard to monitor Enterprise Services too, which allows you to view Interface and Node status panels on a single page.  You can also group any related Interfaces/Nodes together to view them all at one location. Further, the MSP authorization system supports the Enterprise Services when added as a dashboard component. 


Image Added

Service Metrics

  • Node Status:The Node Status is calculated from the status events for the

...

  • Nodes. It aggregates the status event levels and

...

  • presents an average of 0% to 100%.
  • Node State: If any

...

  • Node is unreachable, the

...

Interfaces

Interfaces down metrics are calculated by getting all interface inventory with the status "Interface Down", and store a count of these interfaces.

The overall interface status is calculated from all interfaces related status level and averaged out.

If any interface is marked "Interface Down" the enterprise service is marked unreachable.

Monitored Services

All service inventory tagged with the enterprise service name is aggerated to get the current status. If any monitored service is marked down then  enterprise service is marked unreachable.

Overall State

The overall state of the enterprise service is taken from the worst state of each one of the services.

...

Enterprise Service Rules

...

  • Node State is marked

...

  • Down. If any Node is reachable, but it is not at its optimal level/health, the Node State is marked Degraded, otherwise it is Normal.

  • Interface Status: The Interface Status is calculated by aggregating all the Interface-related status event levels and averaging them out 0% to 100%.
  • Interface State: If any Interface is marked Down, the Interface State is marked Down, otherwise it is Normal.

  • Monitored Service Status: The Service Status shows the average status event level of all Monitored Services for the Enterprise Service 0% to 100%.
  • Monitored Service State: If any Monitored Service is marked Down, then the Service State is marked Down, otherwise it is Normal.

  • Overall Status: The Overall Status can be

    Status
    colourGreen
    titleUp
    Status
    subtletrue
    colourYellow
    titleDegraded
    , or
    Status
    colourRed
    titleDown

    The Overall Status of the Enterprise Service is calculated from the worst of the Node State, Interface State and Service State.

    Node StateInterface StateService State
    Overall Status
    DownDownDown
    Down
    Degraded
    Degraded
    Degraded
    NormalNormalNormal
    Up


Enterprise Service Rules

Enterprise Service rules calculate how each group of entities control the status of the service.

Code Block
{
    "default": {
        "levels": {
            "node_status": [
                "reachable",
                100,
                "degraded",
                90,
                "unreachable",
                10
            ],
            "interface_status": [
                "reachable",
                100,
                "degraded",
                90,
                "unreachable",
                10
            ],
            "monitored_services_status": [
                "reachable",
                100,
                "degraded",
                90,
                "unreachable",
                10
            ],
            "nodes_unreachable": [
                "unreachable",
                1,
                "reachable",
                0
            ],
            "interfaces_unreachable": [
                "unreachable",
                1,
                "reachable",
                0
            ]
        }
    }
}

...

Enterprise Service.  The Enterprise Service rules are defined in /usr/local/omk/conf/ES_Rules.json

The rules set out levels on how each component should be degraded, based on the status level. It is set as an array of Level Type and Level.

For example, Normal - 100, Degraded – 90 would mean, a status of 99 would be Reachable but a status of 89 would be Degraded.

You can use this to tune the alerts. For example, you can configure a proactive enterprise alert for any service if any Level Type is not Normal.

Adding Nodes, Interfaces and Monitored Services

After creating a new Enterprise Service on the opCharts, you can add Nodes, Interfaces and Monitored Services status to it. At the top of the Enterprise Service page you will see a row of buttons for each option:

Image Added


Click on one of the options, and the page for that option will load. You can navigate to the add/edit page by clicking on the edit button - for example, below indicates the Nodes page and the 'Edit Nodes' button:

Image Added


Click the '+' icon to add a Node

Image Added

Add an Interface

To add a new interface, press the "+" icon in the Interfaces section as shown in the screen shot above.  Enter or select the node name, select the interface index/name and press "Add".


Add a Node

Adding a Node is similar, press the "+" icon in the Nodes section.  Enter the node name and press the "Add" button, a node panel for and the selected node should now be displayedwill be added to Enterprise Service.



Add a Monitored Service


Remove an Interface, Node or Service

To remove either, press the "x" icon near the top right of the panel and it will be removed from the document.  Save the document to accept your changes.

Repair RBAC for an Enterprise Service

We changed how an Enterprise Service is referenced in the database with opCharts-4.5.0 and this causes issues with RBAC (portal users) for Enterprise Services created before 4.5.0.

Easy method, delete the Enterprise Service and recreate with the same name, the nodes, interfaces and services will still be attached to the Enterprise Service.

You will need to add the roles you had before.