Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
004a769
1256: add new custom alerts; setup-alerts-and-notifications
Nadia-JSch Apr 23, 2026
8a3fc45
1267: document record change detection and excluded fields; use-fresh…
Nadia-JSch Jun 5, 2026
01a85b1
1268: document IIS connection-string credential redaction; applicatio…
Nadia-JSch Jun 5, 2026
a59852a
1269: document hiding and disabling Advanced Reporting; advanced-repo…
Nadia-JSch Jun 8, 2026
5479229
1269: align reports index pages with Advanced Reporting sunset; repor…
Nadia-JSch Jun 8, 2026
4a2080c
1269: replace Advanced Reporting section with sunset notice; purchases
Nadia-JSch Jun 8, 2026
9d1cf43
1270: document chat history visibility by user role; insightsai
Nadia-JSch Jun 8, 2026
8a89ef7
1271: note how to change the URL in Insights+ report links; insights-…
Nadia-JSch Jun 9, 2026
cafdf7e
1272: note that broadcast and subnet addresses are skipped; discovery…
Nadia-JSch Jun 9, 2026
ca42df0
1273: document blank Nameserver behavior and fix broken scan-setup im…
Nadia-JSch Jun 9, 2026
0010355
1274: add Recovery Services Vault to discovery items table; azure-aut…
Nadia-JSch Jun 9, 2026
849b6f1
1277: document Ignore Powered Off VMs option and Solaris LDOM behavio…
Nadia-JSch Jun 9, 2026
bffa373
1278: document System Management BIOS version mapping; intune-autodis…
Nadia-JSch Jun 9, 2026
fb126c7
1279: document VRF Group column on IP addresses list page; ip-addresses
Nadia-JSch Jun 9, 2026
df13f37
1280: note ITSM Integration sync alerts; use-freshservice-integration
Nadia-JSch Jun 9, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions docs/apps/application-components/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,12 @@ Once converted, the process is treated as a full Service and can be used like an

Device42 automatically categorizes Application Components by **Database** or **Web Server**. You can filter the list page based on this **Category**, and can categorize your custom components as well.

:::info
When Device42 discovers IIS Application Components, it detects passwords in connection strings and replaces them with `<redacted>` before storing the data, so these credentials are not mirrored in Device42.

The sensitive values still exist in plain text in your IIS instance and should ideally be resolved using more secure methods.
:::

<ThemedImage
alt="Application components list view"
sources={{
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -255,6 +255,7 @@ The following Azure resources are discoverable. Instances of Azure Database for
| VMs | Devices > All Devices | management.core.windows.net | Name, OS version, RAM size, CPU, IP, MAC | `Microsoft.Compute/virtualMachines/read`, `Microsoft.Network/networkInterfaces/read`, `Microsoft.Network/publicIPAddresses/read` |
| Blob Storage | Resources > All Resources | management.azure.com | Capacity, available capacity | `Microsoft.Storage/storageAccounts/read`, `Microsoft.Storage/storageAccounts/blobServices/containers/read`, `Microsoft.Storage/storageAccounts/privateEndpointConnections/read`, `Microsoft.Network/privateEndpoints/read` |
| Workspaces | Resources > All Resources | management.azure.com | | `Microsoft.OperationalInsights/workspaces/read` |
| Recovery Services Vault | Resources > All Resources | management.azure.com | Name, subtype, tags | `Microsoft.RecoveryServices/vaults/read` |
| Extended Summary Discovery | Resources > All Cloud Resources | management.azure.com | | `Microsoft.Resources/subscriptions/resourceGroups/read` |
| Extended Summary Discovery Supplementary Permissions | Resources > All Cloud Resources | management.azure.com | | `microsoft.aad/domainservices/read`, `microsoft.alertsmanagement/smartdetectoralertrules/read`, `microsoft.compute/disks/read`, `microsoft.compute/sshpublickeys/read`, `microsoft.compute/virtualmachines/extensions/read`, `microsoft.compute/virtualmachinescalesets/read`, `microsoft.containerservice/managedclusters/read`, `microsoft.dbforpostgresql/flexibleservers/read`, `microsoft.documentdb/databaseaccounts/read`, `microsoft.insights/actiongroups/read`, `microsoft.insights/components/read`, `microsoft.insights/datacollectionrules/read`, `microsoft.managedidentity/userassignedidentities/read`, `microsoft.migrate/migrateprojects/read`, `microsoft.network/applicationgateways/read`, `microsoft.network/connections/read`, `microsoft.network/dnsresolvers/read`, `microsoft.network/loadbalancers/read`, `microsoft.network/localnetworkgateways/read`, `microsoft.network/networkinterfaces/read`, `microsoft.network/networksecuritygroups/read`, `microsoft.network/networkwatchers/read`, `microsoft.network/networkwatchers/flowlogs/read`, `microsoft.network/privatednszones/read`, `microsoft.network/privatednszones/virtualnetworklinks/read`, `microsoft.network/privateendpoints/read`, `microsoft.network/publicipaddresses/read`, `microsoft.network/routetables/read`, `microsoft.network/virtualnetworkgateways/read`, `microsoft.network/virtualnetworks/read`, `microsoft.operationalinsights/querypacks/read`, `microsoft.operationalinsights/workspaces/read`, `microsoft.operationsmanagement/solutions/read`, `microsoft.recoveryservices/vaults/read`, `microsoft.servicebus/namespaces/read`, `microsoft.storage/storageaccounts/read`, `microsoft.web/serverfarms/read`, `microsoft.web/sites/read`, `Microsoft.Resources/subscriptions/resourceGroups/read/read` |

Expand Down
12 changes: 12 additions & 0 deletions docs/auto-discovery/cloud-auto-discovery/intune-autodiscovery.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -126,6 +126,18 @@ After clicking **Save**, the job details page is displayed. Click **Run Now** to

Intune OS data has lower precedence than data from more authoritative sources, like OS-level discovery. For example, the Device42 agent will pick up "Microsoft Windows 10 Enterprise" more quickly than the generic Intune name "Windows". The lower precedence ensures more detailed OS names are collected, enhancing the data-filtering capability of the agent.

## Intune BIOS Version

Intune discovery maps the System Management BIOS version (the `systemManagementBIOSVersion` value from Intune) to the **Version** field in the **BIOS Info** section of the device detail view.

<ThemedImage
alt="BIOS Info section on the device detail view"
sources={{
light: useBaseUrl('/assets/images/intune-autodiscovery/bios-info-light.png'),
dark: useBaseUrl('/assets/images/intune-autodiscovery/bios-info-dark.png'),
}}
/>

## Rename Intune Devices

Devices within Intune are renamed during the build process. If a device name is not updated as expected following Device42 discovery, or after being renamed and updated in Intune, ensure the **Overwrite existing device hostname with discovered hostname** option is enabled.
Expand Down
1 change: 1 addition & 0 deletions docs/auto-discovery/virtual-machine-auto-discovery.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -152,6 +152,7 @@ Configure hypervisor-specific settings for VM discovery.
- **Toggle service level on VM power state:** If a VM is powered off, marks that VM as "Not in Service".
- **Get Guest OS Info:** Retrieves the guest OS information for a VM from VMware. Not as detailed as machine-level WMI or SSH discovery.
- **Ignore Guest UUID:** Do not discover the guest UUID number.
- **Ignore Powered Off VMs:** Do not discover VMs that are powered off. This setting also applies to logical domains (LDOMs) on Solaris devices. When enabled, inactive LDOMs are not discovered. When disabled, both inactive and active LDOMs are discovered.
- **Discover vCloud:** Discovers vCloud instances (if using vCloud connector for vSphere, vRealize, and so on) and creates custom fields for any VMware tags.

### Miscellaneous Options
Expand Down
9 changes: 6 additions & 3 deletions docs/getstarted/using-device42/discovery-hub.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,10 +32,10 @@ To set up a Discovery Hub scan, name the scan and select the [Remote Collector](
Enter the IP information in the box highlighted in the image below and click on the **up arrow** button. You can enter as many targets as you like, but the more targets you include, the longer the scan will likely take.

<ThemedImage
alt="Discovery Hub menu"
alt="Enter scan IP targets"
sources={{
light: useBaseUrl('/assets/images/discovery-hub-onboarding/adm-off-light.png'),
dark: useBaseUrl('/assets/images/discovery-hub-onboarding/adm-off-dark.png'),
light: useBaseUrl('/assets/images/discovery-hub-onboarding/scan-enter-ip-light.png'),
dark: useBaseUrl('/assets/images/discovery-hub-onboarding/scan-enter-ip-dark.png'),
}}
/>
<br/><br/>
Expand Down Expand Up @@ -107,6 +107,8 @@ The scans you have created will be displayed in the left-hand column. Once start

From the **Network Scan Settings** tab, you can schedule the scan by clicking on the **+ Add schedule** button.

Leave the **Nameserver** field empty to use the system DNS servers, or enter DNS servers to use specific resolvers.

<ThemedImage
alt="Network Scan settings tab"
sources={{
Expand Down Expand Up @@ -193,3 +195,4 @@ From the **Settings** tab of completed Discovery Hub scans, you can see the link
- We recommend running one scan at a time, at least initially, to prevent inundating the network.
- If a scan is stopped, it cannot be resumed. A new scan needs to be created to finish scanning those remaining targets.
- Scans are completed with Nmap data, so there could be some variability in the data as it fingerprints the OS.
- Discovery Hub skips the network and broadcast address of each scanned subnet (for example, `.0` and `.255` in a `/24` range), so these addresses are not targeted.
20 changes: 4 additions & 16 deletions docs/infrastructure-management/accounting/purchases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -87,13 +87,13 @@ A few things to note:

## Reporting

:::info
If you are looking for other types of reports, see the dedicated [Reports section](/reports/reports/index.mdx).
:::caution
Advanced Reporting will be removed from the product in a future release. Device42 is in the process of adding all of its capabilities to [Standard Reports](reports/reports/standard-reports.mdx) and [Insights+](reports/reports/insights-plus.mdx), so no reporting capabilities will be lost. Use those features for any new reports. Administrators can [hide the Advanced Reporting menu](reports/reports/advanced-reporting.mdx#hide-the-advanced-reporting-menu) for all users.
:::

You can generate different kinds of purchase reports. Standard Reports display data in tabular format. Advanced Reporting displays data in a tabular format (ExpressView or ExpressReport) and has options for visual items like charts, maps, gauges, and dashboards.
Standard Reports display data in tabular format.

The [Insights+](https://www.device42.com/insights-plus/) option, located on the menu bar, offers powerful features for interpreting your data. See the [Insights+ documentation](/reports/reports/insights-plus.mdx) for more information.
The [Insights+](https://www.device42.com/insights-plus/) option, located on the menu bar, offers powerful features for interpreting your data. See the [Insights+ documentation](reports/reports/insights-plus.mdx) for more information.

<ThemedImage
alt="Reports menu"
Expand All @@ -114,15 +114,3 @@ Navigate to **Analytics > Standard Reports** and click **Create**. Select **Purc
dark: useBaseUrl('/assets/images/purchases/new-standard-report-dark.png'),
}}
/>

### Advanced Reporting

Device42 features an [Advanced Reporting](../../reports/reports/creating-reports.mdx) engine. Navigate to **Analytics > Advanced Reporting**, click the **plus icon** on the left, and choose **Advanced Report**.

<ThemedImage
alt="Create new Standard Report"
sources={{
light: useBaseUrl('/assets/images/purchases/advanced-reporting-create-light.png'),
dark: useBaseUrl('/assets/images/purchases/advanced-reporting-create-dark.png'),
}}
/>
6 changes: 3 additions & 3 deletions docs/infrastructure-management/ipam/ip-addresses.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ The IP list page includes a **Devices** column displaying all devices associated

Navigate to **Resources > IPs > All IP Addresses** to view the IP addresses list page.

The list page shows IPv4 and IPv6 addresses that you can sort by any field. You can also filter by type, availability, updated time stamp, subnet, VRF group, and tags. Search for IPs with full or partial entries, and click on any IP to view its details.
The list page shows IPv4 and IPv6 addresses that you can sort by any field. A **VRF Group** column displays the VRF group that each IP address belongs to. You can also filter by type, availability, updated time stamp, subnet, VRF group, and tags. Search for IPs with full or partial entries, and click on any IP to view its details.

<ThemedImage
alt="IP Addresses list page"
sources={{
light: useBaseUrl('/assets/images/ipam-ip-addresses/ip-addresses-list-light.png'),
dark: useBaseUrl('/assets/images/ipam-ip-addresses/ip-addresses-list-dark.png'),
light: useBaseUrl('/assets/images/ipam-ip-addresses/ip-list-page-vrf-light.png'),
dark: useBaseUrl('/assets/images/ipam-ip-addresses/ip-list-page-vrf-dark.png'),
}}
/>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,21 @@ To run the sync immediately, click the **Manual sync** button to reveal the opti

Locate the synced data in Freshservice under **Assets > Inventory**.

### What Counts as a Record Change

A partial sync uses each record's `last_changed` timestamp to decide what to re-sync. Any field change updates `last_changed`, except for the fields below.

| Category | Excluded Fields |
| --- | --- |
| Timestamps and run times | `action_time`, `date_updated`, `last_changed`, `last_discovered`, `last_edited`, `last_failure`, `last_login`, `last_scheduled_run`, `last_timeout`, `last_updated`, `record_created`, `start_time` |
| Status and counters | `discovered_count`, `failure_count`, `last_reported_state`, `last_status`, `number_consecutive_timeouts`, `run_report`, `state`, `stats` |
| Keys and secrets | `nonce`, `priv_key`, `private_key`, `pub_key`, `public_key`, `rc_priv_key`, `rc_pub_key`, `rc_ru_key` |
| Normalized values | `normalized_bladeno`, `normalized_number`, `normalized_port`, `normalized_rack` |
| Location references | `mt_building_id`, `mt_rack_id`, `mt_room_id` |
| Job and logging | `debug_text`, `delete_date`, `free_capacity`, `job_id`, `json`, `license_hints`, `remote_log`, `remote_port_id` |

For example, a discovery job updates `last_discovered` on every run. Because that field is excluded, the device is not flagged as changed and partial syncs stay limited to meaningful changes.

### Asset Matching Logic

The integration matches Device42 devices to Freshservice assets during the sync. It updates the existing asset or creates a new asset if no match is found.
Expand Down Expand Up @@ -87,6 +102,10 @@ To download the full logs, use the **Download Full Log** button in the lower-lef
A full sync will be forced during upgrades to get new data from Device42. The sync history type will be listed as a full upgrade instead of an incremental one until a successful sync has been performed.
:::

### Sync Alerts

You can be notified when a Freshservice sync starts, completes, or fails by setting up an **ITSM Integration** alert. This lets you respond quickly if a sync fails. See [Set Up Alerts and Notifications](reports/reports/setup-alerts-and-notifications.mdx) to configure the alert.

### Cancelled Syncs

When Device42 deploys a new Cloud Connector server as part of its usual maintenance process, running syncs are stopped and marked as **cancelled** in the sync history logs.
Expand Down
4 changes: 3 additions & 1 deletion docs/reports/device42-doql/insightsai.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,9 @@ To save the generated query, click **Report** on the InsightsAI [response toolba

## InsightsAI Chats List Page

Click the **Past Chats** button on the [InsightsAI](#create-a-new-chat) page or the [chat response](#query-result-options) page to navigate to the list page. The InsightsAI Chats List Page contains a record of your past chats that are automatically saved.
Click the **Past Chats** button on the [InsightsAI](#create-a-new-chat) page or the [chat response](#query-result-options) page to navigate to the list page. The InsightsAI Chats List Page contains a record of your past chats that are automatically saved.

Non-admin users can see only their own chats, while admin users can see all users' chat history.

You can create a **New Chat** from the list page.

Expand Down
4 changes: 0 additions & 4 deletions docs/reports/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,6 @@ title: "Reports"
sidebar_position: 1
---

:::info
Note that the much more capable Advanced Reporting Engine has superseded what is now referred to as "Legacy Reporting", and should be utilized for creation of any new reports going forward.
:::

These sections cover entries found in the reporting menu of the Device42 appliance. This is broken into a main [Reporting section](./reports/index.mdx), an [overview of the Device42 Object Query Language](./device42-doql/index.mdx), and a [Data Building Blocks Cookbook](./dbb-cookbook/index.mdx) that is a collection of queries you might find useful.

Explore these categories and dive into specific sub-pages using the sidebar on the left.
Expand Down
34 changes: 33 additions & 1 deletion docs/reports/reports/advanced-reporting.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,41 @@ import ThemedImage from '@theme/ThemedImage'
import useBaseUrl from '@docusaurus/useBaseUrl'

:::caution
We are primarily invested in **[Standard Reports](standard-reports.mdx)** and **[Insights+](insights-plus.mdx)** and encourage customers to use those first.
Advanced Reporting will be removed from the product in a future release. Device42 is in the process of adding all of its capabilities to **[Standard Reports](standard-reports.mdx)** and **[Insights+](insights-plus.mdx)**, so no reporting capabilities will be lost. Use those features for any new reports.
:::

## Hide the Advanced Reporting Menu

This setting is for on-premise installations only.

You can hide the **Advanced Reporting** menu for all users of your instance, even when the feature is enabled by your license. This lets you direct users to [Standard Reports](standard-reports.mdx) and [Insights+](insights-plus.mdx) instead.

Navigate to **Tools > Settings > Global Settings** and select the **Hide Advanced Reporting** option. The menu is shown by default.

<ThemedImage
alt="Hide Advanced Reporting setting"
sources={{
light: useBaseUrl('/assets/images/advanced-reporting/hide-advanced-reporting-light.png'),
dark: useBaseUrl('/assets/images/advanced-reporting/hide-advanced-reporting-dark.png'),
}}
/>

After you select this option, going to **Analytics > Reports > Advanced Reporting** initially displays a reporting-disabled notice. The **Advanced Reporting** menu item is then removed.

<ThemedImage
alt="Reporting disabled notice"
sources={{
light: useBaseUrl('/assets/images/advanced-reporting/reporting-disabled-notice-light.png'),
dark: useBaseUrl('/assets/images/advanced-reporting/reporting-disabled-notice-dark.png'),
}}
/>

### Toggle Advanced Reporting in the Appliance Manager

You can also enable and disable Advanced Reporting from the the Appliance Manager under **Application > Exago Reports**.

![Exago Reports settings](/assets/images/advanced-reporting/exago-reports.png)

## Advanced Reporting Engine Overview

Device42's Advanced Reporting engine is a quantum leap forward in functionality. It is a fully incorporated, schedulable BI or reporting platform that lets you create both ad-hoc reports that may include visualizations, and export the output in different formats as desired. A changing selection of predefined reports is included with Advanced Reporting, while an unlimited number may be added under **User-Defined** reports, exported, imported, and shared!
Expand Down
2 changes: 1 addition & 1 deletion docs/reports/reports/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@
title: "Reports"
---

These sections cover entries found in the reporting menu of the Device42 appliance. Note that the much more capable Advanced Reporting Engine has superseded what is now referred to as "Legacy Reporting", and should be utilized for creation of any new reports going forward.
These sections cover entries found in the reporting menu of the Device42 appliance. Advanced Reporting will be removed from the product in a future release — use [Standard Reports](standard-reports.mdx) and [Insights+](insights-plus.mdx) for any new reports. Administrators can [hide the Advanced Reporting menu](advanced-reporting.mdx#hide-the-advanced-reporting-menu) for all users.
Loading