Manage dashboards and widgets

Create a dashboard

1. Click Dashboards > New dashboard.
2. Enter the dashboard name.
3. Select the dashboard layout.
4. Click Save.
5. Add new widgets to the dashboard by clicking Dashboard options > Add widget. For more information on the widgets available, see Widget list.
6. If you want the dashboard to be your default landing page, follow the procedure Set a dashboard to display after login.

Delete a dashboard

1. Click Dashboard options > Delete this dashboard.
2. Click Delete.

Rename a dashboard

1. Click Dashboard options > Rename this dashboard.
2. Enter the new name.
3. Click Save.

Share a dashboard

Only users with the Dashboard Share right, found under the Dashboard category in the Group rights function, can share dashboards.

When sharing dashboards with users or groups that are managed by LDAP or Active Directory, the name or user group name is not auto-completed. The same applies to local users and groups if the user is not a member of a group with the Access Rights right. This does not prevent you from sharing dashboards with them, as long you enter the name of the user or group correctly.

For more information on access rights, see Update user permissions in Manage users, contacts, and permissions.

To share a dashboard:

1. Click Dashboard options > Share this dashboard. Users or groups which are already sharing the dashboard are listed at the bottom.
2. Choose whether to share the dashboard with a Group or User.
3. Select the name of the group or user from the drop-down list.
4. Click Share. The new user or group is added to the list.

To stop sharing a dashboard:

1. Click Dashboard options > Share this dashboard. Users or groups which are already sharing the dashboard are listed at the bottom.
2. Click the cross next to the user or group with which you no longer want to share the dashboard.
3. Click Stop sharing.

Create a local user account

To be able to display content in an external widget, you need to configure a local user account for the widget in OP5 Monitor.

1. Create a new local user account. For example, externalview. For guidance, see Create a user in Manage users, contacts, and permissions.
2. Assign minimal permissions to the new user to be able to view the type of widget contents, such as NagVis > NagVis View or Host > Host View All. For guidance, see Update OP5 Monitor user permissions in Manage users, contacts, and permissions.
3. Log the user in to the OP5 Monitor user interface to create the necessary user configuration. 

Configure the widget

1. Log on to the OP5 Monitor system as root, using SSH.
2. Create a new file called external_widget.php using the following command:

   cp -pv /opt/monitor/op5/ninja/application/config/custom/external_widget.php

3. Open the newly created file using a text editor:

   edit /opt/monitor/op5/ninja/application/config/custom/external_widget.php

4. The new file is created with comment blocks beginning with /* ... */, and several lines beginning with $config, which you need to update as follows:
   1. Set the username parameter to the name of the user you created in Create a local user account:

      $config['username'] = 'externalview'; 

   2. Set the groups parameter to the user group of the user. If the user does not have a password configured, you must specify the group name manually. In this example, the group is set to guest as follows:

      $config['groups'] = array('guest');

      Alternatively, for several group memberships, specify them as comma-separated values, as follows:

      $config['groups'] = array('guest', 'external_users');

   3. Set the widgets parameter according to one of the examples below.

      NagVis example

      $config['widgets']['company_network'] = array(
      'name' => 'nagvis',
      'friendly_name' => '',
      'setting' => array(
      'width' => 1280,
      'height' => 1024,
      'map' => 'automap'
      		)
      		);

      List view example

      $config['widgets']['unhandled_problems'] = array(
       'name' => 'listview',
       'friendly_name' => '',
       'setting' => array(
       'query' => '[services] state != 0 and acknowledged = 0 and scheduled_downtime_depth = 0 and host.scheduled_downtime_depth = 0',
       'columns' => 'default',  
       'limit' => 50, 
       'order' => ''
                 )            
                 );
      

Display the widget

Add an iframe to the HTML of the external website to display the external widget. For example:

<iframe src="https://<OP5_monitor_server>/monitor/index.php/external_widget/company_network" height="500px" frameborder=0 width="600px" scrolling='no'></iframe>

You need to set company_network in the URL to the name you created for the configuration.