Configure Amazon QuickSight ((only if QuickSightPrincipalArn was provided as a CloudFormation parameter) - Discovering Hot Topics using Machine Learning

Configure Amazon QuickSight ((only if QuickSightPrincipalArn was provided as a CloudFormation parameter)

After the stack is successfully deployed, you can retrieve the Amazon QuickSight URLs from the Outputs tab.

Important

The QuickSight datasets created by this solution use Direct Query to query S3 buckets for data. For better performance, you may use use SPICE. Refer to Using SPICE Data in an Analysis in the Amazon QuickSight User Guide for more information about configuring and using SPICE.

Use the following steps to launch the Amazon QuickSight dashboard and view the analysis.

  1. Sign in to the AWS Management Console and navigate to Amazon QuickSight.

  2. Change the Region in the URL to match the Region where you deployed the solution. For example, if the solution was deployed in the us-east-1 Region, the QuickSight URL will mirror the following path: https://us-east-1.quicksight.aws.amazon.com/sn.

  3. From the left navigation menu in QuickSight, choose Analyses. The right pane displays the analysis that the solution automatically created: SO0122-<version-solution-name>. Double-click the analysis title to open it.

Use the following steps to configure Amazon QuickSight permissions and complete the dashboard set up.

Note

Based on the Topic job frequency schedule and the time at which the solution was deployed, it can take up to 24 hours post deployment for the some of the visuals to render. All jobs are scheduled in the UTC time zone.

  1. Select your username, then choose Manage QuickSight.

  2. From the left navigation menu, select Security & Permissions.

  3. Under QuickSight access to AWS Services, choose Add or Remove.

  4. Select IAM, Amazon S3, and Amazon Athena. If these options are already selected, uncheck and recheck the options.

  5. Choose Amazon S3, select Details, choose Select S3 buckets, then choose the S3 bucket name that matches the following pattern: <stackname>-infoutput-<uuid>. If the solution has been successfully ingesting feeds for more than 10 minutes after deployment, this S3 bucket will contain some or all of following object keys: entity, keyphrase, moderationlabels, sentiment, topic-mappings, topics, txtinimgentity, txtinimgkeyphrase, txtinimgsentiment.

Important

As of February 2021, there is a known issue with the Amazon QuickSight template feature. If your QuickSight template contains visuals with column groups in the field wells, your dashboard may not render correctly. If you receive a No data error, you can use the following procedure to reconfigure your analysis, update the geospatial properties, and generate a successful visual.

Use the following procedure to correct the No data error in Amazon QuickSight.

  1. Open either the Text Analysis or Analysis by Geography tab and select the map visual.

    Note: You must complete this procedure for both tabs to resolve this error.

  2. Select Field wells to view the Geospatial properties. The expected output for this setting should include both latitude (lat) and longitude (lon). Figure 12 shows the expected output for normal operation.

    Figure 13: Expected behavior for geospatial properties in the Field wells architecture

  3. If only latitude (lat) is displayed, you can correct the error by removing the property and manually adding latitude (lat) and longitude (lon).

    1. From the Geospatial box, select the arrow to the right of lat, then choose Remove.

    2. Drag the geo-coordinates column group (including lat and lon) from the Fields List into the Field Wells. For more details, refer to Using Visual Field Controls in the Amazon QuickSight User Guide.