Overview

This article describes how to enable deep linking in BrightGauge. Deep linking turns datapoints into hyperlinks connected directly to a datasource. For example, if you enable deep linking for ConnectWise PSA™ (Manage), clicking a ticket number on a gauge in BrightGauge opens the ticket in PSA. Deep linking does not apply to client reports and is only available for select data sources.

Deep linking is available for the following data sources:

• ConnectWise PSA On-Premises
• ConnectWise PSA Cloud
• ConnectWise Automate On-Premises
• ConnectWise Automate Cloud
• Autotask
• Datto REST API
• Kaseya BMS
• ServiceNow
• ZenDesk

ConnectWise PSA (On-Premises)

To enable deep linking for on-premises PSA:

1. Navigate to DATA > Datasources.
2. Select ConnectWise PSA On-Premise.
3. In the Deep Linking section, enter your ConnectWise PSA URL and Company Name.
   
4. Select your Locale.
5. Click Save.

After deep linking is enabled, gauges powered by datasets with the following fields link directly to ConnectWise PSA web:

• ticket_number
• config_recid
• opportunity_recid
• so_activity_recid
• Time_RecID

ConnectWise PSA (Cloud)

To enable deep linking for hosted PSA:

1. Navigate to DATA > Datasources.
2. Select ConnectWise PSA Cloud.
3. In the Deep Linking section, select your Locale.
   
4. Click Save.

After deep linking is enabled, gauges powered by datasets with the following fields link directly to ConnectWise PSA web:

• ticket_number
• config_id
• opportunity_recid
• so_activity_recid
• Time_RecID

ConnectWise Automate (On-Premises)

For ConnectWise Automate on-premises, you will have to go to your data source and enter your URL. Once that is complete, any gauges being powered off datasets with the following field will be hyperlinked back to your ConnectWise Automate web portal.

• computer_id

ConnectWise Automate (Cloud)

For hosted ConnectWise Automate, deep linking will automatically be configured using your company URL that is required for the general data source configuration. Any gauges being powered off datasets with the following field will be hyperlinked back to your ConnectWise Automate web portal.

• computer_id

Autotask

For Autotask users, it's simply entering in the Autotask URL you use to access Autotask. For example, see below.

Once you get that updated in your data sources page, the field "ticket_id" is hyperlinked in any drilldown or list gauge. Please note, this ticket id field is different from the ticket_number field.

Datto REST

Deep linking is enabled automatically for the Datto REST API data source. This means that after the data source is connected, the available fields become hyperlinks in drilldown and list gauges. For Datto REST, the deep linking fields are:

• device_serial_number
• last_screenshot_url

Kaseya BMS (Vorex)

For Kaseya BMS users, this feature works straight out of the box as you already use your BMS URL to connect the data source. This means that after the data source is connected, the available fields become hyperlinks in drilldown and list gauges. For BMS, the fields are:

• ticket_id
• account_id
• hardware_asset_id
• software_asset_id
• opportunity_id
• activity_id
• project_id
• invoice_id
• contract_id

ServiceNow

For ServiceNow users, deep linking works straight out of the box. Once the data source is connected, the available fields become hyperlinks in drilldown and list gauges. For ServiceNow, the deep linked fields are:

• change_request_id
• company_id
• contract_sla_id
• incident_id
• problem_id
• service_catalog_request_item_id
• service_catalog_request_id
• survey_response_id
• user_id
• task_id
• task_sla_id
• task_time_entry_id

ZenDesk

For ZenDesk users, this feature works straight out of the box as you already enter their ZenDesk URL to connect the data source. This means that once the data source is connected, the field "ticket_number" will be hyperlinked in any drilldown or list gauge. Please note, this "ticket_number" field is different from the "id" field.