Workspace Environment Management

Reports

Provides reports that let you analyze your deployments.

Introduction

This page provides reports that let you analyze your deployments. Reports are generated on a per-event basis. However, not all events generate corresponding reports. Currently, events of the following types generate reports:

  • Scripted task

    • Each time a task runs, a corresponding report is generated. The reports include information about when the task runs, the task execution results, and more.
    • Both built-in and custom tasks generate reports. In those reports, we provide predefined report data. When adding custom tasks, you can customize the data to be reported. If the predefined report data does not suit your needs, consider using the extended data for further analysis.
  • Profile container status

    • Each time a profile container is attached, a corresponding attach record is generated. We consolidate those records into a single report on a daily basis. The report includes information about the basic usage data of the profile containers, the status of sessions using the profile containers, the issues detected, and more. With the information, you can track storage usage for profile containers and identify problems that prevent profile containers from working.
  • Optimization and usage

    • With Enable data collection and upload for optimization and usage insights enabled for a configuration set on its Advanced Settings > Insights page, the agent collects and uploads optimization and usage data on a daily basis. A report based on the collected data is generated.
  • Optimization and usage insights

    • Each time you apply insights for a configuration set, a corresponding report on optimization and usage is generated. The reports let you gain insights into application behavior. We aggregate usage and optimization insights into one report.

    Note:

    On the Optimization Insights or the Usage Insights page of Monitoring > Insights, you apply insights by selecting a configuration set and a date range. We maintain only one report for insights applied using the same configuration set and date range. Applying insights using the same configuration set and date range updates the report later.

  • Profile Management health check

    • The agent runs Profile Management health checks every 24 hours or on demand. A corresponding report is then generated. The report contains the following elements:

      • Date and time when the report was generated
      • Detailed information such as the associated agent and configuration set
      • Issues (for example, errors and warnings) found, along with fix recommendations
    • To change your Profile Management settings, go to Profile Management Settings. To customize the scope of settings to cover in a report, go to Advanced Settings > Monitoring Preferences under that configuration set.

Each report appears as a table record. Those reports provide useful diagnostic information that can inform your action. For example, you can check reports based on event severity. Based on the severity level, you can decide what action to take.

Tip:

We have pre-defined levels of severity for certain reports, for example, built-in scripted task reports.

For a scripted task, the Result code column can provide the following information:

  • 0: Indicates that the task has run successfully.
  • -4: Appears when attempts to verify the checksum of the executable file you provided failed.
  • -5: Appears when attempts to verify the signature of the executable file failed. Possible causes: no valid signature at the end of the executable file, or signature verification failure because of certificate missing.

For information about result codes (status codes) of profile container status, see the Microsoft documentation https://docs.microsoft.com/en-us/fslogix/fslogix-error-codes-reference. Remember: “-1” means that WEM could not retrieve the status code.

Columns to display and filters

You can customize the display of the table. Click Columns to display to choose which columns you want to display. When customizing columns, you must select at least two columns. After you complete your customization, the table refreshes to display the columns you select.

You can click a column heading to sort. You can apply filters to filter reports.

View more details of a report

You can select a report for more detailed information. To do that, locate the report and then click the ellipsis on the right. The report wizard appears. It contains two tabs:

  • Details. Provides a detailed result summary.
  • Raw data. Provides raw data related to the report. The extended data is in JSON format. If needed, use the extended data for further analysis.

For a scripted task that has Highlight regular expression matches enabled, you can see the following option on the Details tab of its report:

  • View regular expression matches. Lets you view regular expression matches in detail.

Export reports

You can export the data in each report in CSV or JSON format, which opens in programs such as Microsoft Excel. To do that, perform the following steps:

  1. Click Export. The export wizard appears.

  2. Select the export format. Available options: CSV and JSON.

  3. Optionally, select Save a copy of the export to your local machine. The export will be saved to the default download location of your browser.

  4. Click Export to start the export process.

Important:

  • You can export up to 50,000 records (reports). When the number of records to export exceeds the limit, only the top 50,000 will be exported. We recommend that you use filters to reduce the number of records to 50,000 or fewer.
  • While an export is in progress, you cannot perform another export.
  • If an export does not complete within 30 minutes, you will no longer receive notifications about it. Go to Files to view the export result later.
  • When exporting reports, the export will be saved to the cloud storage. The cloud storage has a storage limit. When you reach the limit, you cannot proceed with the export. In that case, go to Files and delete unnecessary files to free up space. See Files.
Reports