...

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 add this to opCommon.json

Code Block
"beta":{ "opcharts_enterprise_services": "true" },

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

Node status is calculated from the status events for the node, it aggerates the status event levels and averages out the current status.

If any node is unreachable the enterprise service is marked unreachable, if nodes are degraded but none are unreachable the enterprise service is marked degraded.

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

...

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 status panels for Interfaces, Monitored Services and Nodes on a single page. You can also group any related Interfaces/Monitored Services/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

Enterprise Service Metrics

Nodes State: If any Node is unreachable, the Nodes State is marked Down. If any Node is degraded, the Nodes State is marked Degraded, otherwise it is Normal.
Interfaces State: If any Interface is marked Down, the Interfaces State is marked Down, otherwise it is Normal.
Services State: If any Monitored Service is marked Down, then the Services State is marked Down. If any Monitored Service is degraded, the Services State is marked Degraded, otherwise it is Normal.

Overall State: The Overall State can be Status
colour Green
title Up
, Status
colour Yellow
title Degraded
, or
Status
colour Red
title Down

The Overall State of the Enterprise Service is calculated from the worst of the Nodes State, Interfaces State and Services State, where Up is best and Down is worst.
So if each State is Normal, the Overall State will be Up, but if any of the States is Down the Overall State will be Down, or if the States are Normal and Degraded then the Overall State will be Degraded.

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%.
Interface Status: The Interface Status is calculated by aggregating all the Interface-related status event levels and averaging them out 0% to 100%.
Service Status: The Service Status shows the average status event level of all the Monitored Services for the Enterprise Service 0% to 100%.

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. 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

In opCharts 4.8.1 and newer you can now add Nodes, Interfaces and Monitored Services directly to an Enterprise Service from their relevant views.

Choose the items that you want added to an Enterprise Service using opCharts' advanced filtering capabilities, then to the left click on the checkbox for that item/s. You will notice a new button become visible, click this and then click on 'Enterprise Service'. You can then choose the Enterprise Service to add to.

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.

Versions Compared

Old Version 6

New Version Current

Key

Overview