diff --git a/docs/apps/application-components/index.mdx b/docs/apps/application-components/index.mdx index a3b1c0adb..6a4762b48 100644 --- a/docs/apps/application-components/index.mdx +++ b/docs/apps/application-components/index.mdx @@ -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 `` 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. +::: + 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` | diff --git a/docs/auto-discovery/cloud-auto-discovery/intune-autodiscovery.mdx b/docs/auto-discovery/cloud-auto-discovery/intune-autodiscovery.mdx index e430e82ca..74de83003 100644 --- a/docs/auto-discovery/cloud-auto-discovery/intune-autodiscovery.mdx +++ b/docs/auto-discovery/cloud-auto-discovery/intune-autodiscovery.mdx @@ -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. + + + ## 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. diff --git a/docs/auto-discovery/virtual-machine-auto-discovery.mdx b/docs/auto-discovery/virtual-machine-auto-discovery.mdx index b424b5944..383ddd197 100644 --- a/docs/auto-discovery/virtual-machine-auto-discovery.mdx +++ b/docs/auto-discovery/virtual-machine-auto-discovery.mdx @@ -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 diff --git a/docs/getstarted/using-device42/discovery-hub.mdx b/docs/getstarted/using-device42/discovery-hub.mdx index 698d115cc..ee1f9ea05 100644 --- a/docs/getstarted/using-device42/discovery-hub.mdx +++ b/docs/getstarted/using-device42/discovery-hub.mdx @@ -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.

@@ -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. + 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**. - - diff --git a/docs/infrastructure-management/ipam/ip-addresses.mdx b/docs/infrastructure-management/ipam/ip-addresses.mdx index 385c81684..666bcbabb 100644 --- a/docs/infrastructure-management/ipam/ip-addresses.mdx +++ b/docs/infrastructure-management/ipam/ip-addresses.mdx @@ -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. diff --git a/docs/integration/external-integrations/freshservice-integration/use-freshservice-integration.mdx b/docs/integration/external-integrations/freshservice-integration/use-freshservice-integration.mdx index 7d1ed5a57..372a45081 100644 --- a/docs/integration/external-integrations/freshservice-integration/use-freshservice-integration.mdx +++ b/docs/integration/external-integrations/freshservice-integration/use-freshservice-integration.mdx @@ -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. @@ -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. diff --git a/docs/reports/device42-doql/insightsai.mdx b/docs/reports/device42-doql/insightsai.mdx index bf46eb246..1a43b593c 100644 --- a/docs/reports/device42-doql/insightsai.mdx +++ b/docs/reports/device42-doql/insightsai.mdx @@ -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. diff --git a/docs/reports/index.mdx b/docs/reports/index.mdx index 51f334541..dd6431ceb 100644 --- a/docs/reports/index.mdx +++ b/docs/reports/index.mdx @@ -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. diff --git a/docs/reports/reports/advanced-reporting.mdx b/docs/reports/reports/advanced-reporting.mdx index 39c5564a6..764e39841 100644 --- a/docs/reports/reports/advanced-reporting.mdx +++ b/docs/reports/reports/advanced-reporting.mdx @@ -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. + + + +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. + + + +### 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! diff --git a/docs/reports/reports/index.mdx b/docs/reports/reports/index.mdx index c89c56a54..69a8637c7 100644 --- a/docs/reports/reports/index.mdx +++ b/docs/reports/reports/index.mdx @@ -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. diff --git a/docs/reports/reports/insights-plus.mdx b/docs/reports/reports/insights-plus.mdx index 7388c5030..83f941fd6 100644 --- a/docs/reports/reports/insights-plus.mdx +++ b/docs/reports/reports/insights-plus.mdx @@ -264,6 +264,22 @@ WHERE DATE(first_added) = CURRENT_DATE AND tags IS NULL - Select **Email** as the **Notification method**, and then enter the recipient email addresses (separated by commas or semicolons). - Click **Save** to save the alert. +### Change the Emailed Report URL + +Emailed reports and alerts include links back to the dashboard or chart in Device42. To change the URL used in these links, navigate to **Tools > Cloud Services**, click **Edit**, and update the **D42 URL for SaaS apps** field with the URL or IP address you want. + + + +:::caution +**D42 URL for SaaS apps** is a global setting used by your external and SaaS integrations. Changing it affects how those integrations reference your Device42 instance, not just the links in emailed Insights+ reports and alerts. See [Cloud Services Settings](integration/external-integrations/cloud-services-settings.mdx) for details. +::: + ## DCIM Dataset, Chart, and Alert Example This section provides examples of how to take existing Device42 datasets and transform them into analytics of your own. For these datasets, you will first need to clone the dataset into one that you own and manage, so that our system dashboards are not affected by any analysis you want to do. This is most easily done by exploring the dataset and viewing it in the SQL Editor. Here, you can save it as a new dataset and label it something meaningful. diff --git a/docs/reports/reports/setup-alerts-and-notifications.mdx b/docs/reports/reports/setup-alerts-and-notifications.mdx index d844e1d72..cf41f2529 100644 --- a/docs/reports/reports/setup-alerts-and-notifications.mdx +++ b/docs/reports/reports/setup-alerts-and-notifications.mdx @@ -148,6 +148,12 @@ When you are done, click one of the **Save** options at the bottom of the page. - Any Remote Collector Disconnected - Any WDS Disconnected +**ITSM Integration** + +- Sync Failed +- Sync Started +- Sync Completed + **UPS** - Battery % Capacity Remaining @@ -377,6 +383,19 @@ Device42 supports the following variables for embedding within alert emails when Any WDS Disconnected
%(wds_ip)s + + +

ITSM Integration

+ + Sync Failed +
%(itsm_url)s - integration URL
%(itsm_type)s - integration type
%(status)s - sync status
%(msg)s - details
%(priority)s - priority + + + Sync Started + + + Sync Completed +

UPS

diff --git a/docs/reports/reports/use-custom-sql-advanced-report.mdx b/docs/reports/reports/use-custom-sql-advanced-report.mdx index 7ace38622..d52951496 100644 --- a/docs/reports/reports/use-custom-sql-advanced-report.mdx +++ b/docs/reports/reports/use-custom-sql-advanced-report.mdx @@ -3,6 +3,12 @@ title: "Use Custom SQL in Advanced Report" sidebar_position: 17 --- +:::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](standard-reports.mdx)** and **[Insights+](insights-plus.mdx)**, so no reporting capabilities will be lost. Use those features for any new reports. + +Administrators can [hide the Advanced Reporting menu](advanced-reporting.mdx#hide-the-advanced-reporting-menu) for all users. +::: + Advanced reporting in Device42, introduced mid-2018, empowers you to create and schedule extremely complex reports that the old reporting engine simply couldn't handle. You can also combine all of the built-in reports and features that advanced reporting includes out-of-the-box with your own custom SQL objects to achieve an entirely new level of reporting flexibility, including using SQL's ability to pre-process and transform objects as part of your query. ## Create an Advanced Report Using Custom SQL diff --git a/static/assets/images/advanced-reporting/exago-reports.png b/static/assets/images/advanced-reporting/exago-reports.png new file mode 100644 index 000000000..4c407817b Binary files /dev/null and b/static/assets/images/advanced-reporting/exago-reports.png differ diff --git a/static/assets/images/advanced-reporting/hide-advanced-reporting-dark.png b/static/assets/images/advanced-reporting/hide-advanced-reporting-dark.png new file mode 100644 index 000000000..18976ed91 Binary files /dev/null and b/static/assets/images/advanced-reporting/hide-advanced-reporting-dark.png differ diff --git a/static/assets/images/advanced-reporting/hide-advanced-reporting-light.png b/static/assets/images/advanced-reporting/hide-advanced-reporting-light.png new file mode 100644 index 000000000..ce4a69a4c Binary files /dev/null and b/static/assets/images/advanced-reporting/hide-advanced-reporting-light.png differ diff --git a/static/assets/images/advanced-reporting/reporting-disabled-notice-dark.png b/static/assets/images/advanced-reporting/reporting-disabled-notice-dark.png new file mode 100644 index 000000000..a6059af02 Binary files /dev/null and b/static/assets/images/advanced-reporting/reporting-disabled-notice-dark.png differ diff --git a/static/assets/images/advanced-reporting/reporting-disabled-notice-light.png b/static/assets/images/advanced-reporting/reporting-disabled-notice-light.png new file mode 100644 index 000000000..c0aa9eaa5 Binary files /dev/null and b/static/assets/images/advanced-reporting/reporting-disabled-notice-light.png differ diff --git a/static/assets/images/insights-plus/cloud-services-dark.png b/static/assets/images/insights-plus/cloud-services-dark.png new file mode 100644 index 000000000..cd7b57dfa Binary files /dev/null and b/static/assets/images/insights-plus/cloud-services-dark.png differ diff --git a/static/assets/images/insights-plus/cloud-services-light.png b/static/assets/images/insights-plus/cloud-services-light.png new file mode 100644 index 000000000..47b4285c4 Binary files /dev/null and b/static/assets/images/insights-plus/cloud-services-light.png differ diff --git a/static/assets/images/intune-autodiscovery/bios-info-dark.png b/static/assets/images/intune-autodiscovery/bios-info-dark.png new file mode 100644 index 000000000..96c2d6ddb Binary files /dev/null and b/static/assets/images/intune-autodiscovery/bios-info-dark.png differ diff --git a/static/assets/images/intune-autodiscovery/bios-info-light.png b/static/assets/images/intune-autodiscovery/bios-info-light.png new file mode 100644 index 000000000..26b4e4d3b Binary files /dev/null and b/static/assets/images/intune-autodiscovery/bios-info-light.png differ diff --git a/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-dark.png b/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-dark.png new file mode 100644 index 000000000..c12f4a4d6 Binary files /dev/null and b/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-dark.png differ diff --git a/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-light.png b/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-light.png new file mode 100644 index 000000000..86c6a3d92 Binary files /dev/null and b/static/assets/images/ipam-ip-addresses/ip-list-page-vrf-light.png differ diff --git a/static/assets/images/purchases/advanced-reporting-create-dark.png b/static/assets/images/purchases/advanced-reporting-create-dark.png deleted file mode 100644 index 71d33f3c9..000000000 Binary files a/static/assets/images/purchases/advanced-reporting-create-dark.png and /dev/null differ diff --git a/static/assets/images/purchases/advanced-reporting-create-light.png b/static/assets/images/purchases/advanced-reporting-create-light.png deleted file mode 100644 index 05fd9c7f5..000000000 Binary files a/static/assets/images/purchases/advanced-reporting-create-light.png and /dev/null differ