4. Widgets

Widgets

All widgets have General tab and some of them have a separate tab with settings specific to the widget

General Tab Fields:

• Type - type of widget f.e AEM Bundle, AEM Healthcheck
• Title - any text
• Columns - set widget width in grid
• Rows - set widget height in grid
• Go to new line - check if widget should be displayed in new line
• Disabled - check if widget should have disabled state

*Expandable Content - option that allows you to display a large amount of content in the form of expandable content. Option is is not available for all widget. Take a look at screens below

AEM Bundle Info

Configuration:

• Endpoint - choose AEM endpoint
• Schedule Period - time interval between executions >> recommended: 300 (5min)
• Error threshold for 'resolved' bundles - how many bundles with status resolved are needed to throw an error instead of warning
• Error threshold for 'installed' bundles - how many bundles with status installed are needed to throw an error instead of warning
• Excluded bundles - list of bundles to be ignored when calculating widget status; can be either display name or symbolic name. Excluded bundles will be put in a separate section, with an option to view them all (including statuses).

Tested on AEM 6.5 & 6.4, should work on all modern/recent-ish versions

AEM Healthcheck

Configuration:

• Endpoint - choose AEM endpoint
• Schedule Period - time interval between executions >> recommended: 300 (5min)
• Health Checks - choose health checks which you would like to show*

* There are other health checks available in AEM. If other checks are desirable they can be added easily by contributing to: cogboard-webapp/src/constants/index.js#AEM_HEALTH_CHECKS constant.

Tested on AEM v.6.5

Bamboo Deployment

Configuration:

• Endpoint - choose configured Bamboo endpoint
• Schedule Period - time interval between executions >> recommended: 300 (5min)
• ID - choose deployment which you would like to show

Where to find ID?

1. Go to <bamboo_host>/deploy/viewAllDeploymentProjects.action

2. Click on deployment from list

3. Project page opens:

   • In URL you will find ID number >> <bamboo_host>/deploy/viewEnvironment.action?id=1234567

Tested on Bamboo v.6.1.1

Bamboo Plan

Configuration:

• Endpoint - choose configured Bamboo endpoint
• Schedule Period - time interval between executions >> recommended: 300 (5min)
• ID - choose plan you would like to show

Where to find ID?

1. Go to <bamboo_host>/allPlans.action
2. Click on plan from list
3. Project page opens:
   • In URL you will find ID number >> <bamboo_host>/browse/CSOI-SDFAPTAS

Tested on Bamboo v.6.1.1

Checkbox

Description:

Widget displays one of three status icons:

• success (green checkmark)
• failure (red cancel icon)
• indeterminate (indeterminate checkbox icon)

Users can toggle widget state by clicking its area.

State can also be updated by sending a POST request to content update endpoint: http://<board_host>/api/widget/contentUpdate for example using curl command in the CLI (first ensure that curl is installed on the machine):

curl -d '{"id": "widget17","content": {"widgetStatus": "CHECKBOX_OK"}}' -H "Content-Type: application/json" -X POST http://<board_host>/api/widget/contentUpdate

The JSON body of the request should follow the example structure:

{
  "id": "widget17",
  "content": {
    "widgetStatus": "CHECKBOX_FAIL"
  }
}

where:

• id - the widget ID that can be copied from widget edit dialog.
  
• widgetStatus - widget status to be set, possible vaues are: CHECKBOX_OK, CHECKBOX_FAIL, CHECKBOX_UNKNOWN

Configuration:

No additional configuration needed

Iframe Embed

Configuration:

• URL - URL of a page that will be embedded as an iframe in a widget
  example: https://www.youtube.com/embed/uBP9K2QJSSs

Jenkins Job

Configuration:

• Endpoint - choose Jenkins endpoint*
• Schedule Period - time interval between executions | recommended: 300 (5min)
• Path - path to the job | example: /job/ProjectName/job/build-name

* example Jenkins Endpoint props:

  {
    id: "endpoint1",
    label: "Jenkins Endpoint",
    url: "http://internal.url or http://ip.address",
    publicUrl: "https://external.url",
    credentials: "credential2"
  }

Tested on Jenkins v.2.46.3

Jira Buckets

Description:

Widget displays the amount of Jira issues in user defined buckets. Buckets of issues can be added, deleted and edited.

Configuration:

• Endpoint - choose Jira endpoint
• Schedule Period - time interval between executions | recommended: 300 (5min)
• Maximum number of issues - limit of the issues pulled from Jira in every bucket
• Bucket Name - name of the user defined bucket
• JQL Query - user defined query that matches the ticket requirements*

*JQL - Jira Query Language documentation

You can also use build-in jira search:

and copy the jql query parameter value from URL

Link List

Description:

Widget displays list of links specified be user. Items can be added, deleted and edited.

Configuration:

• Link Title - any ext
• Link Url - url to external website

Random Picker

Description:

Widget cycle through defined text items in scheduled time intervals. Admin user can force item picking with a refresh button.

Configuration:

• Randomize - By default widget cycle throw items in LIFO order, if this is enabled items are selected randomly
• Daily - If enabled next value will be selected in next day - minute after midnight
• Interval - Interval between cycling items in minutes
• Entries - List of values to be showed

Service Check

Configuration:

• Schedule Period - time interval between executions >> recommended: 300 (5min)
• Request Method - choose request method >> GET | PUT | POST | DELETE
• Content Type - choose header content type >> application/json | application/xml | multipart/form-data | text/html | text/plain
• Endpoint - choose service endpoint
• Path - service url >> example: /login
• Response Body Fragment - response body fragment that is expected for this service
• Expected Status Code - status code that is expected for this service >> default: 200

Presentation

Widget displays:

• Expected status code. If the response status code is different it shows ex. "200 EXPECTED, GOT 404"
• Response status:
  • MATCH - response includes expected response fragment
  • NOT MATCH - response not includes expected response fragment
  • OK - when expected response body remains empty
• Response body message - in a popover after hovering a mouse over response status

SonarQube

Configuration:

• SonarQube Version - 7.x, 6.x or 5.x supported
• Endpoint - choose Jenkins endpoint*
• Schedule Period - time interval between executions | recommended: 300 (5min)
• Key - project key | example: com.cognifide.zg:com.cognifide.zg:stable
• Metrics - choose metrics which you would like to show

Where to find Key and Index?

1. Go to <sonarqube_host>/dashboard/index
2. Click on project from list
3. Project page opens:
   • In URL you will find ID number | <sonarqube_host>/overview?id=316488
   • On a page (upper-right corner) you will find Key

* example SonarQube Endpoint props:

  {
    id: "endpoint2",
    label: "SonarQube Endpoint",
    url: "http://internal.url or http://ip.address",
    publicUrl: "https://external.url",
    user: "user.name",
    password: "pass",
    token: "token"
  }

• user should fill one of two login options: password or token field

Tested on SonarQube v.5.6.6 | v.6.7.3 | v.7.9.1

Text

Configuration:

• Text - any text (multiple lines allowed)
• Text Size - text sizes from XXS to XXL >> default: M
• Vertical Text - rotate text by 90 degrees >> default: false

ToDo List

Description:

Widget displays list of items specified be user. Items can be added, deleted and edited. You can check the done items.

Configuration:

• Item Title - any text (multiple lines allowed)

White Space

Description:

It creates a blank space between widgets.

Configuration:

No additional configuration needed. This widget is invisible when the user logged out.

World Clock

Description:

Widget displays current time and date of the specific timezone

Configuration:

• Timezone - choose GMT timezone
• Date Format - choose date display format
• Time Format - choose between 12 or 24 hour time format
• Display date - check if date should be displayed
• Display time - check if time should be displayed
• Text Size - choose size of date and time

Zabbix

Description:

Widget is able to show information about: cpu, ram, heap, disk, logged users, uptime and number of processes.

Configuration:

It is mandatory to fill all the fields with proper content to have properly working widget.

• Endpoint - choose Zabbix endpoint -> endpoint URL and Public URL must have /zabbix/api_jsonrpc.php on the end
• Schedule Period - time interval between executions
• Host - provide host name, host name shouldn't be taken from group level. Choose lower level host name - e.g. pre-cog-front-publisher01.dll.dlgpl.net
• Metric - choose which metric should be displayed:
  • Active users
  • Available Memory
  • CPU Utilization
  • Mem heap size
  • Number of processes
  • System uptime
  • Used disk space
  • Used swap space

Next two configuration fields are available only if specific metric will be selected e.g. available memory, disk space etc. This is due to the fact that in some cases the progress bar will be displayed. So we need to specify range and maximum value, which will be used to calculate the percentage value.

• Max Value - provide max value for metric (in GB)
• Range - define the range where the widget will display ok, warning or error status based on the percentage value

LogViewer

Description:

Widget displays logs from remote server and store them. LogViewer connects to endpoint via SSH and collects logs from defined file. You can filter logs by date, level and regular expressions.

Configuration:

• Endpoint - choose endpoint from which you want to acquire logs (requires endpoint with ssh connection credentials)
• Schedule Period - time intervel between retrieving logs from server
• Path - path to file with logs
• Maximum number of lines to return - maximum number of lines that will be shown by widget
• Log file size lmit - limit of size for logs stored in database for this widget(in MB)
• Log record expiration date - number of days after which logs will be deleted from database

Searching:

Values written in field will be highlighted. Any log that is a match will also receive a yellow checkmark in the upper left corner. There is a 0.5 second debounce on input and you have to provide at least 3 characters.

Filters:

Logs that doesn't match all filters will not be listed. Date and level fields aren't checked.
Manage filters with Advanced section. Hover over filter to view its regular expression. Modify filters using wrench or add new. New filters are enabled by default. You can enable/disable filters using multiselect list.

Log level filter:

Logs are listed if their level is greater or equals current log level (default INFO).

Date span:

Date span allows users to show logs only from selected time interval

Quarantine:

Quarantine is used to reject logs on the backend side. After setting a quarantine rules all stored logs are checked if they fit any rule. If they do, logs are deleted from database. Arriving logs are also checked and they're not saved if any of the rules is fitting.

Quarantine rules can be set only by users logged as admins. For normal user this option is invisible.

At this moment quarantine modal can be accessed by Quarantine button. (It is planned to be moved into Advanced)

Quarantine modal and form is quite similar to filters, except it has one more element, which is reasaon why we want this rule to be set.

Follow logs and clear logs:

New logs are always at the end of list, so if user want to see them, he has to scroll to the bottom of view. This button allows him to automatically scroll to the bottom every time widget is refreshed. On scrolling up function disables.

To clear all logs from view, Clear logs button is used, which sets previously described date span begin date to current date.

Filters, Log level and Date span settings are saved in users browser local storage.