- Standard dashboards, documented on this page
- Classic dashboards, based on Grafana
Standard dashboards aren’t available to all Cortex XCOR users and might
not be visible in your app. For information about enabling this feature in your
environment, contact Cortex XCOR Support.
View dashboards
Select from the following methods to view your available dashboards.- Web
- Chronoctl
- API
To search for a dashboard from anywhere in Cortex XCOR:
- Click the global search bar to focus on it, or use the keyboard shortcut
Control+K(Command+Kon macOS). - Click the Dashboards filter.
- Begin typing any part of the dashboard’s name.
- Click a dashboard listed in the search results to view it, or use the arrow keys
to select the result and press
Enter(Returnon macOS).
- To filter the table’s contents by name, enter part or all of a dashboard name into the Search dashboards field.
- To filter the table by team or owner, use the Select a team or Select an owner dropdown. Select a name or enter part or all of one to filter the dropdown options.
- To filter the table by tag, click Select a tag and select its name from the suggestion list, or enter part or all of a tag name into the field to filter the list.
- To filter the table to display only your favorite dashboards, click the View only my favorites toggle.
- Include connected dashboards: If you filter dashboards by owner while the toggle is disabled, you’ll only get dashboards owned by that owner. When the toggle is enabled, your filter includes dashboards that are connected to that owner, even if they aren’t owned by that owner. Connections are based on collections.
View Cortex XCOR-managed dashboards
Cortex XCOR includes several dashboards to visualize information about itself and its usage within your organization. For more information, see Cortex XCOR-managed dashboards.Create or import a dashboard
To add a dashboard, you can:Create a new dashboard
Select from the following methods to create a new dashboard. You can create a dashboard in the Cortex XCOR web interface, or define the dashboard in code and upload it. See the dashboard configuration schema for help defining fields in code.- Web
- Chronoctl
- Terraform
- API
These steps apply only to standard dashboards. For classic dashboards, see
Classic dashboards.
- In the navigation menu select Dashboards.
- Click + Add.
- In the menu that appears, click New dashboard to open the Add dashboard dialog.
- Enter a descriptive name in the Dashboard name field.
- Enter an Owner in the corresponding fields to associate the dashboard with a Collection or Service.
- Optional: Enter Tags in the corresponding field to associate the dashboard with key-value tag pairs.
- Click Save.
Duplicate a dashboard
You can duplicate dashboards, including in Cortex XCOR, and then customize the duplicate. Cortex XCOR-managed dashboards can be duplicated but not deleted.- In the Dashboards page, click the three vertical dots icon and then click Duplicate. Alternately, when viewing a dashboard, click More actions > Duplicate dashboard.
-
Enter the following information:
- Dashboard name: A name for the new dashboard.
- Owner: The service or collection that owns this dashboard.
- Optional: Select tags for the dashboard.
- Click Save.
Import a dashboard with JSON
Cortex XCOR lets you upload one or more dashboards as JSON files. To do so:- In the navigation menu select Dashboards.
- Click + Add.
- In the menu, click Import dashboard to open the Import Dashboards dialog.
- Click Import or Drag and Drop dashboard JSON File to upload one or more exported dashboard JSON files, or drag and drop a dashboard JSON into the Import Dashboard JSON field. If the file fails validation, the dialog displays an error message that describes the failure. There is one entry for each uploaded file.
- In the Upload Settings section, select an Owner for the dashboard to associate the dashboard with a collection or service.
- Optional: Add a Tag.
- Optional: Enter a descriptive name in the Name field. The field default is the import file’s name.
- Optional: Enter Tags in the corresponding field to associate the dashboard with key-value tag pairs.
- Click Import Dashboards to import the dashboard.
Dashboard uploaded success message.
Import a classic dashboard
You can import a Grafana dashboard as a classic dashboard with Chronoctl or Terraform. To convert an existing classic dashboard into a standard dashboard instead, see Migrate to standard dashboards.Summarize your dashboard
This feature isn’t available to all Palo Alto Networks Cortex XCOR users and
might not be visible in your app. For information about enabling this feature in your
environment, contact Cortex XCOR Support.
- Overview: A high-level summary of the dashboard’s purpose, the data it visualizes, and its potential uses.
- Key Panel Groups: A list of summaries for each panel group in the dashboard.
- Variables: A list of summaries for each variable in the dashboard.
Edit a dashboard with Operator
This feature is in Early Access (EA), and might not be visible in your app. To learn
more about this program and the features it contains, see the
Early access page.
- Open the dashboard you want to change.
- Click Ask Operator in the page header, or press A.
-
Describe the change you want. For example:
Add a panel showing request rate by status code for the checkout service.
Edit your dashboard settings
Users can modify Terraform-managed resources only by using Terraform.
Learn more.
Rename a dashboard
Select from the following methods to rename a dashboard.- Web
- Chronoctl
- Terraform
- API
To rename a dashboard:
- Select the dashboard you want to rename.
- Click Settings.
- Enter a new name in the Dashboard name field.
- Click Apply, and then click Save on the dashboard itself to save the change.
Reassign a dashboard’s owner
Select from the following methods to reassign a dashboard to a different collection or service.- Web
- Chronoctl
- Terraform
- API
To reassign a dashboard:
- Select the dashboard you want to reassign.
- Click Settings.
- Click the Owner dropdown.
- Scroll through the list and click the collection or service to which you want to assign the dashboard. To filter the list by owner name, begin typing a name into the dropdown field.
- Click Apply, and then click Save on the dashboard itself to save the change.
Create and configure dashboard variables
Dashboard variables let users dynamically redefine parts of panel queries and other features by selecting values from a dropdown or entering them into a field. For details about creating and configuring dashboard variables, see Customize panel queries with dashboard variables. To reuse label and value selections from supported pages as list variable values on a dashboard, see Quick filters.Add events to a dashboard
For information about adding events to a dashboard while viewing it, see Enable change events on dashboards.Review the version history
To view the history of changes made to a dashboard:- Select a dashboard.
- Click More actions.
- Code config: Displays a code representation of the selected entity as of the time of the selected revision.
- Code diff: Displays a Git-style diff of the most-recent change made to the
entity, in Cortex XCOR API format. To compare the selected revision to another
revision in the history, click the Compare With dropdown and select the
timestamp of the revision that you want to compare.
- Click Unified to see the diff stacked horizontally.
- Click Split to see changes side by side.
The Version History view retains up to 500 revisions, or up to 15 months of revisions
if there are fewer than 500 revisions.
Restore a previous version
When reviewing the version history, you can restore a prior version.- Select the version to revert to.
- Click Restore to
DATE, whereDATEis the selected version. - Click Restore.
Connect a dashboard to a service
Services and collections can own dashboards, but you can also connect a dashboard to a service that doesn’t own it. You might have dashboards where different groups have responsibility for handling issues, but the information is important to other groups. To connect a dashboard to a service:- Select a dashboard.
- Click More actions.
- Click Connections.
- Add or remove a connection.
Make your dashboard full screen
Observability teams often use full screen displays for operational dashboards, without menu bars cluttering the workspace. Cortex XCOR makes this feature available as Kiosk mode. To display Cortex XCOR in kiosk mode:- Select a dashboard.
- Change any Compare or time period settings.
- Click More actions.
- Click Kiosk mode.
Esc.
Export a dashboard
Export your dashboard for use by your GitOps or infrastructure as code tools. To view or download the full dashboard’s code in Chronoctl, Terraform, or API format:- Select a dashboard.
- Click More actions.
- Click Code config.
- In the dashboard, click More actions.
- From the menu, select JSON. The Dashboard JSON dialog appears.
- Click Copy to copy the JSON to your clipboard, or click to download the JSON.
Delete a dashboard
Select from the following methods to delete a dashboard.Users can modify Terraform-managed resources only by using Terraform.
Learn more.
- Web
- Chronoctl
- Terraform
- API
These steps apply only to standard dashboards. For classic dashboards, see
Classic dashboards.
- Click Settings.
- Click Delete dashboard.
- In the Delete dashboard dialog, click Delete to confirm the deletion.
Delete from the Dashboards table
- Hold the pointer over a dashboard’s row.
- Click its settings icon.
- Click Delete.
- In the Delete dashboard dialog, click Delete to confirm the deletion.