- Interact with data
- Interact with specific types of panels
- Filter by Fusion request ID
- Open the Service Logs dashboard from a job history
layout: howto title: Use Dashboards in Fusion 4.0.x toc: true product: fusion-server productVersion: 4.0 persona: search-engineer, devops, data-scientist objective: manage, troubleshoot, analyze-data ---
-
Open the default dashboard – Click Goto saved default
.
-
Open a pre-built dashboard – See Use Built-in Dashboards.
-
Load a dashboard from Solr – At the top right of the open dashboard, click Load
. Saved dashboards are listed at the bottom of the dialog box. Click a dashboard to open it. Filter dashboards by entering an exact-match string in the Filter box. If there are more that 20 saved dashboards, use the pagination controls to find a dashboard. To view the next set of pages, click
. To view the prior set of pages, click
. You must click a page number to view the dashboards on that page. This is an example of the controls:
-
Load a dashboard from a file – At the top right of the open dashboard, click Load
. Click Choose File
, browse to and select the file, and then click Open.
-
Load a dashboard from a GitHub gist – Perform these steps:
-
At the top right of the open dashboard, click Load
.
-
Enter the gist URL or number (the last part of the URL). For example:
https://gist.github.com/anonymous/#b10353f36c9fcaaade7db98889e9678b#
-
Click Get
. A link that opens the dashboard appears below a thin line. The link displays the dashboard name. Click the link to open the dashboard. This is an example of the Gist-loading dialog:
-
-
Set a default dashboard for a browser Click Save Dashboard
> Set as Browser Default
.
-
Clear the default dashboard for a browser – Click Save Dashboard
> Clear Browser Default
. The default dashboard for the browser becomes the system default dashboard
default.json
(the Fusion Logs dashboard).
Interact with data
-
Choose the collection from which to obtain data – If a dashboard was configured to let users choose among collections, then you can choose the collection from the Collections drop-down list at the top right of the dashboard.
-
Search – Enter a query term or phrase in a search bar in a Query panel, and then click Search
.
-
Retrieve all data – In the Query panel, enter
:
, and then click Search.
-
Clear a search box and return to the most general query (
:
) – Click Clear Search Box.
-
See that a query is in progress for a panel – At the top right of a panel, the Waiting for Data
indicator shows you that the panel is waiting for the data. If the indicator spins and spins while other panels display data, the panel is not configured correctly.
-
Select a specific data item – In a table, click a row. In a graphical-visualization panel, click a data item. Not all panel types let you select data in this way.
-
Export data – At the top of a panel, click Export
.
-
Hide a row – At the left of the row, click Hide Row
.
-
Expand a hidden row – At the left of the hidden row, click Expand Row
.
Interact with specific types of panels
Following are interactions for specific types of panels.
Table panels
-
Show the field list – At the top left of a Table panel, click Show Field List
.
-
Hide the field list – At the top left of a Table panel, click Hide Field List
.
-
Sort a column in a table into ascending order – At the top of a column, click Sort Ascending
.
-
Sort a column in a table into descending order – At the top of a column, click Sort Descending
.
-
View the next page of hits – At the top or bottom of a page of hits in a Table panel, click Next Page
.
-
View the previous page of hits – At the top or bottom of a page of hits in a Table panel, click Previous page
.
-
View the first page of hits – At the top left of a Table panel, click View First Page
-
Show details for a record in a table – Click a row in a table. Click Table, JSON, or Raw to view the details in those formats.
-
Hide details for a record in a table – At the top right of the details, click Hide Details
.
Full Text Search panels
-
Show details for a record in a Full Text Search panel – Click a row in a Full Text Search panel. Click Table, JSON, or Raw to view the details in those formats.
-
Hide details for a record in a Full Text Search panel – At the top right of the details, click Hide Details
.
Histogram and Range Facet panels
-
Zoom in on a subset of data (Histogram and Range Facet panels) – On the histogram, drag the mouse across the range of data you want to zoom in on.
-
Zoom out from a subset of data (Histogram and Range Facet panels) – Click Zoom Out
.
Filtering panels
-
Edit a filter – Click Edit Filter
.
-
Toggle a filter on and off Click Toggle Filter
.
-
Remove a filter – For the filter that you want to remove, click Remove Filter
.
Note Exercise caution when removing filters. Some panels depend on specific filters being present. Fusion also creates filters based on your interactions with data. You can add a filter back, but there is no undo. You might want to just toggle the filter off instead.
Heat Map panels
-
Transpose rows and columns in a heat map – In a Heat Map panel, click Transpose Rows and Columns
.
Heat Map panels
-
Transpose rows and columns in a heat map – In a Heat Map panel, click Transpose Rows and Columns
.
Filter by Fusion request ID
To only display information about log entries with a specific Fusion request ID, you can filter the contents of a logs dashboard by the Fusion request ID.
You can do this in these ways:
-
Click a link in the error message or toast.
-
Filter in a logs dashboard.
-
Append a query filter parameter to the dashboard URL.
Click a link in the error message or toast
In an API error in the Fusion UI or in an error toast, a View logs dashboard link is present. Click the link to view the dashboard using a filter for that request ID.
API error with link in Fusion UI:
API error toast with link:
Filtered Service Logs dashboard:
Clicking a View logs dashboard link opens the Service Logs dashboard and filters by the Fusion request ID. Notice the filtering query for the mdc_requestId_s
field. In this example, the fusion-request-id
is BWQSjPPYgB
.
Filter in a logs dashboard
In the Service Logs, Access Logs, or Combined Logs dashboard, you can filter by Fusion request ID.
To do so:
-
Obtain the Fusion request ID returned by a request. For example, notice the Fusion request ID
BWQSjPPYgB
returned by this API command:curl -v -u admin:password http://127.0.0.1:8764/api/apps/inventory * Trying 127.0.0.1... * TCP_NODELAY set * Connected to 127.0.0.1 (127.0.0.1) port 8764 (#0) * Server auth using Basic with user 'admin' > GET /api/apps/inventory HTTP/1.1 > Host: 127.0.0.1:8764 > Authorization: Basic YWRtaW46UGFzc3dvcmQxMjM= > User-Agent: curl/7.54.0 > Accept: */* > < HTTP/1.1 404 Not Found < Content-Type: application/json < fusion-request-id: BWQSjPPYgB < Server: Jetty(9.3.8.v20160314) < Set-Cookie: id=4962c806-f3b5-485f-8fb4-c20e608b700c;Path=/;HttpOnly < Content-Length: 394 < Connection: close < { "type" : "RESTError", "httpStatusCode" : 404, "error" : "ERR-0003", "message" : "A web application error occurred", "details" : "The Fusion App with id 'inventory' does not exist", "cause" : null, "requestId" : "BWQSjPPYgB", "httpStatusMessage" : "Not Found", "localizedMessage" : "The Fusion App with id 'inventory' does not exist", "suppressed" : [ ], "class" : null * Closing connection 0 }
-
Open a logs dashboard.
-
Specify the Fusion request ID in the Filter panel, with a query for the
mdc_requestId_s
field that specifies the value offusion-request-id
for which you want to search.
In this example, the fusion-request-id
is BWQSjPPYgB
:
Append a query filter parameter to the dashboard URL
As an alternative to constructing a query filter in the dashboard, you can append a query filter parameter to the dashboard URL. In the query filter, use the field name mdc_requestID_s
.
Example 1: Default dashboard (Service Logs)
Example 2: Combined Logs dashboard
Example 1: Default dashboard (Service Logs)
Example 2: Combined Logs dashboard
Open the Service Logs dashboard from a job history
-
Open the job history. For most jobs, click Collections
> Jobs, select a job, and then click Job History. For datasource jobs, click Indexing
> Datasources, select a datasource, and then click Job History.
In the job history, you will see a link named
runId
: -
Click the link to view the Service Logs dashboard filtered by the
runId
: