Menu
Lumberyard
User Guide (Version 1.15)

Using the Defect Reporter Cloud Gem Portal

Use the Defect Reporter Cloud Gem Portal to view and manage defect report submissions. You can use the Defect Reporter Cloud Gem Portal to do the following:

  • View, filter, and manage reports.

  • Perform ANSI SQL queries on report fields.

  • Add comments and bookmark reports.

  • Mark reports as read or unread.

  • View report submissions by time range.

  • Reuse queries and create shareable URLs for them.

  • Configure the display of report details.

  • Create custom data collection fields.

You can use the DefectReporterSample level to generate sample reports and then view and manage them in the Cloud Gem Portal.

Prerequisites

This tutorial assumes the following:

  • You are using version 1.15 or later of Lumberyard.

  • You have used the Project Configurator to set CloudGemDefectReportSample as your default project.

  • You used the Cloud Canvas Resource Manager or the lmbr_aws command line tool to create the following:

    • A project stack for your project.

    • A deployment for your project that has the CloudGemDefectReporter and CloudGemMetric cloud gems enabled.

  • You have opened the Cloud Gem Portal.

If you don't meet the prerequisites, see Choosing a Game Project to Open to set CloudGemDefectReportSample as your default project. For information on how to create a project stack and a deployment stack, see Tutorial: Getting Started with Cloud Canvas.

Opening the Defect Reporter Cloud Gem Portal

To open the Defect Reporter Cloud Gem Portal

  1. In Lumberyard Editor, choose AWS, Cloud Gem Portal.

  2. In the Cloud Gem Portal, on the Cloud Gems page, click Defect Reporter.


          Choose the Defect Reporter cloud gem in the Cloud Gem Portal.
Viewing, Filtering, and Managing Reports

The Overview tab displays the list of defects that occurred.


          Overview tab

To view, filter, and manage reports

  1. To see partially hidden column names, expand the column or pause your pointer on the column header.

    
              Full column header in tooltip
  2. To sort reports by a specific column, click the column name.

  3. To filter the columns that are displayed, click the Columns drop-down menu and select the columns that you want.

    
              Filtering columns with the Columns selector
  4. To view only reports that have been read or not yet read, click the Status drop-down menu.

    
              Filtering reports by read status

    Note

    To mark a report as read or unread, use the Report Detail page for the report.

  5. To limit the number of results that are displayed, click the number drop-down menu next to the Search box.

    
              Limiting the number of displayed results for reports.
  6. To filter the results for specific data, enter the parameters of a standard ANSI SQL WHERE clause into the Search Defects box, and then click Search.

    
              Using SQL to query defect reports in the Defect Reporter Cloud Gem
                Portal.
  7. To remove the filter, clear the Search Defects box, and then click Search again.

  8. To bookmark a report, click the bookmark icon next to the report.

    
              Bookmarking a report in the Defect Reporter Cloud Gem Portal.

    The reports that you bookmark appear on the Bookmarks tab.

Viewing Report Details

On the Overview tab, click a report to see detailed information on the Report Detail page.


          Report details page in the Defect Reporter Cloud Gem Portal.

To view report details

  1. To download a screenshot file, DxDiag file, or game log file, click the file name.

    Note

    A download link can be provided for game-specific attachments like audio snippets. However, if you want to make such attachments available for presentation in the Cloud Gem Portal, custom code is required.

  2. To customize the fields that appear under the Report Information, Player Information, and System Information sections, see the Report Configuration tab.

Adding Comments, Bookmarks, and Changing Read Status

On the upper right of the Report Detail page, you can use the Add Comment, Add to Bookmarks, and Mark as Read options for your report.


            Report detail page options

After you bookmark a report or mark the report as read, the Remove from Bookmarks and/or Mark as Unread options are available for the report.


            Report detail page toggle options
  • To view the reports that you bookmark, use the Bookmarks tab.

  • To filter for reports that are read or unread, you can use the Status drop-down menu on the Overview or the Bookmarks tab.

  • To return to the Overview tab, click Back to Defect List.

Working with Comments

On the Report Details page, you can add, edit, and delete comments about a report.

Adding a Comment to a Report

You can add comments to a report for tracking purposes.

Note

Comments added to a report are separate from the Player text (annotations) that the player submits.

To add a comment to a report

  1. Click Add Comment.

    
                  Click Add Comment to add a comment to a
                    report
  2. In the Add Comment dialog box, enter your changes, and then click Add.

    
                  Adding a comment in the Comment box

    The new comment appears on the details page for the report.

    
                  Comment added to a report detail page.

Editing Comments

You can edit existing comments for a report.

To edit a comment

  1. On the report's detail page, click the gear icon next to the comment.

    
                  Editing a comment on the report's detail page.
  2. In the Edit Comment dialog box, enter your changes, and then click Add.

    
                  Editing a comment in the Comment box

Deleting Comments

To delete a comment

  • Click the trash icon next to the comment.

    
                  Deleting a comment

Viewing Unfiltered Report Data

To view all the information in a defect report (including information like log and DxDiag content), click the Raw Data tab.


            Viewing unfiltered data on the Raw Data tab
Discovering Defect Submission Trends by Time Range

On the Dashboard tab, you can see bar graphs of trends that show the number of submitted defects for a specific time range.

To see trends in report submissions for a preset time range

  • Click the Select Time Period drop-down menu and select a time range.

    
              Selecting a preset time range in the Defect Reporter Cloud Gem
                Portal.

    A bar graph for the selected time range appears.

    
              Bar graph of submission trends for a preset time range
Viewing and Managing Bookmarked Reports

On the Bookmarks tab, you can view and manage the reports that you bookmarked.

Note

You can bookmark a report on the Overview tab or the Report Detail page for the report.


          Viewing bookmarked reports on the Bookmarks tab

To view and manage bookmarked reports

  1. To see the Report Detail page for the report, click the report entry.

  2. To sort a report table by column, click the column name.

  3. To filter the bookmarked reports, you can use the Columns and Status options just as you can on the Overview tab.

  4. To remove the bookmark from a report (and the report from the Bookmarks tab), click the bookmark icon next to the report.

Reusing Searches

On the Recent Searches tab, you can see the 10 most recent searches.


          Viewing recent searches on the Recent Searches tab

To reuse searches

  1. On the Recent Searches page, click the query.

    
              Rerunning a search
  2. To copy a shareable URL of the query, click the share icon.

    
              Creating a shareable query URL

    You can send the URL to other users with credentials to your Cloud Gem Portal to run the same query in a browser.

Configuring the Report Detail Page

On the Report Configuration tab, you can manage the fields that appear on the Report Detail page.


          Data mappings on the Report Configuration tab.

You can add, remove, change the display name, and change the display category of the fields.

To add a display field to the Report Detail page

  1. From the Raw Data page, note the field name that you want to appear on every report's detail page.

  2. Click the Report Configuration tab.

  3. Click Add Mapping.

    
              Click Add Mapping to add a field to the Report
                  Detail page

    This adds an empty field to the top of the data mappings list.

    
              Data mapping field added
  4. For Key, enter the field name that you chose from the Raw Data tab (for example, event_sequence_number).

  5. For Display Name, enter the field name that you want to appear on the Report Detail tab (for example, Event Sequence).

  6. For Display Category, select one of the Category options (for example, Report Information).

    • Report Information

    • Player Information

    • System Information

    
              Choosing the display category for a field on the Report
                  Detail page

    The next time you display the detail page for a report, the new field is displayed under the category that you chose.

    The following example has added the event_sequence_number field to the Report Information section using the display name Event Sequence.

    
                Field added to the Report Detail page
  7. To remove a field from the report configuration, click the trash icon for the field mapping.

  8. To change the display name for a field, enter the new name in the Display Name box.

  9. To change the display category for an existing field, click the Display Category drop-down menu.

  10. To view the new field, go to the detail page for a report. The new field and its display name appears under the category that you chose.

    Example

    In the Report Information section, the event_sequence_number field appears with the display name Event Sequence.

    
                Field added to the Report Detail page
Creating Custom Data Collection Fields

On the Client Configuration tab, you can create custom data collection fields for client users.

To add a custom client-side data collection field

  1. On the Client Configuration tab, click Add New Field.

    
              Click Add New Field to add a custom data collection
                field
  2. In the Add New Field dialog box, for Field Type, select one of the options:

    • Multiple Choice (Checkboxes)

    • Single Choice (Radio Buttons)

    • Text.

    
              Choosing a data collection field type
  3. For Multiple Choice Options, enter an option, and then click Add Option to add as many options as you require.

    
              Creating a multiple choice data collection field
    
              Click Add Field to save the custom field
  4. For each additional option:

    • Enter the corresponding text.

    • To delete an option, click the red X icon.

    • To cancel the addition of the custom field and all of its options, click Close. Your changes will not be saved.

    • To save the custom field, click Add Field.

    After you click Add Field, the new field appears in the custom field list.

    
              Custom data collection field added to client configuration
  5. For the Single Choice (Radio Buttons) field type, follow the same procedure as for multiple choice. However, users can choose only one of the options that you provide.

    
              Single choice field added to client configuration
  6. For the Text field type, enter a value for Title. For Character Limit, specify the number of characters that users can enter into the text box.

    
              Creating a collection field for text data

    After you click Add Field, the text field appears in the list of custom fields.

    
              Text data field added to client configuration
  7. To edit a field, click the gear icon for the field, make your changes, and then click Save Changes.

    
              Editing a custom data collection field
  8. To delete a field, click the trash icon for the field and in the dialog box, click Delete Field.

    
              Deleting a custom data collection field
  9. To see the custom fields that you defined in the Cloud Gem Portal, run the DefectReporterSample level.

    
              Custom multiple choice field in the DefectReporterSample level
  10. To move from one custom field to the next, use the arrows on the upper right.

    
              Using arrows to navigate custom fields in the DefectReporterSample
                level.
    
              Custom single choice data field in the DefectReporterSample level
    
              Custom text data field in the DefectReporterSample level

On this page: