kendra / Client / get_snapshots

get_snapshots#

kendra.Client.get_snapshots(**kwargs)#

Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.

See also: AWS API Documentation

Request Syntax

response = client.get_snapshots(
    IndexId='string',
    Interval='THIS_MONTH'|'THIS_WEEK'|'ONE_WEEK_AGO'|'TWO_WEEKS_AGO'|'ONE_MONTH_AGO'|'TWO_MONTHS_AGO',
    MetricType='QUERIES_BY_COUNT'|'QUERIES_BY_ZERO_CLICK_RATE'|'QUERIES_BY_ZERO_RESULT_RATE'|'DOCS_BY_CLICK_COUNT'|'AGG_QUERY_DOC_METRICS'|'TREND_QUERY_DOC_METRICS',
    NextToken='string',
    MaxResults=123
)
Parameters:
  • IndexId (string) –

    [REQUIRED]

    The identifier of the index to get search metrics data.

  • Interval (string) –

    [REQUIRED]

    The time interval or time window to get search metrics data. The time interval uses the time zone of your index. You can view data in the following time windows:

    • THIS_WEEK: The current week, starting on the Sunday and ending on the day before the current date.

    • ONE_WEEK_AGO: The previous week, starting on the Sunday and ending on the following Saturday.

    • TWO_WEEKS_AGO: The week before the previous week, starting on the Sunday and ending on the following Saturday.

    • THIS_MONTH: The current month, starting on the first day of the month and ending on the day before the current date.

    • ONE_MONTH_AGO: The previous month, starting on the first day of the month and ending on the last day of the month.

    • TWO_MONTHS_AGO: The month before the previous month, starting on the first day of the month and ending on last day of the month.

  • MetricType (string) –

    [REQUIRED]

    The metric you want to retrieve. You can specify only one metric per call.

    For more information about the metrics you can view, see Gaining insights with search analytics.

  • NextToken (string) – If the previous response was incomplete (because there is more data to retrieve), Amazon Kendra returns a pagination token in the response. You can use this pagination token to retrieve the next set of search metrics data.

  • MaxResults (integer) – The maximum number of returned data for the metric.

Return type:

dict

Returns:

Response Syntax

{
    'SnapShotTimeFilter': {
        'StartTime': datetime(2015, 1, 1),
        'EndTime': datetime(2015, 1, 1)
    },
    'SnapshotsDataHeader': [
        'string',
    ],
    'SnapshotsData': [
        [
            'string',
        ],
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • SnapShotTimeFilter (dict) –

      The date-time for the beginning and end of the time window for the search metrics data.

      • StartTime (datetime) –

        The UNIX datetime of the beginning of the time range.

      • EndTime (datetime) –

        The UNIX datetime of the end of the time range.

    • SnapshotsDataHeader (list) –

      The column headers for the search metrics data.

      • (string) –

    • SnapshotsData (list) –

      The search metrics data. The data returned depends on the metric type you requested.

      • (list) –

        • (string) –

    • NextToken (string) –

      If the response is truncated, Amazon Kendra returns this token, which you can use in a later request to retrieve the next set of search metrics data.

Exceptions

  • kendra.Client.exceptions.InvalidRequestException

  • kendra.Client.exceptions.ResourceNotFoundException

  • kendra.Client.exceptions.AccessDeniedException

  • kendra.Client.exceptions.InternalServerException