AWS connect documentation change
Summary
Added documentation about two access methods (console vs CLI/CloudShell) for the analytics data lake and improved punctuation consistency in table column descriptions
Security assessment
The changes primarily add operational guidance for accessing the data lake and improve grammatical consistency. There is no mention of security controls, vulnerabilities, or security-specific features. The note about using Option 2 if Option 1 fails appears to address accessibility rather than security.
Diff
diff --git a/connect/latest/adminguide/data-lake-botdata.md b/connect/latest/adminguide/data-lake-botdata.md index af3903532..6f742e01f 100644 --- a//connect/latest/adminguide/data-lake-botdata.md +++ b//connect/latest/adminguide/data-lake-botdata.md @@ -10,0 +11,11 @@ This topic details the content in the Amazon Connect analytics data lake bot tab +There are two ways to access the analytics data lake and configure data to be shared: + + * [Option 1: Use the Amazon Connect console](./access-datalake.html#option1-configure-data-to-be-shared) + + * [Option 2: Use CLI or CloudShell](./access-datalake.html#option2-configure-data-to-be-shared) + + + + +If you are unable to access the scheduling tables by using Option 1, try using Option 2. + @@ -30,3 +41,3 @@ Column | Type | Description -event_id | String | This is the primary key of the table. This will be a hash of originating request identifier and session identifier -bot_originating_request_id | String | A unique identifier for a specific bot request -bot_session_id | String | The identifier of the user session that is having the conversation +event_id | String | This is the primary key of the table. This will be a hash of originating request identifier and session identifier. +bot_originating_request_id | String | A unique identifier for a specific bot request. +bot_session_id | String | The identifier of the user session that is having the conversation. @@ -36,6 +47,6 @@ instance_id | String | The identifier of the Amazon Connect instance. -invoking_resource_type | String | Can be flow or module -flow_resource_id | String | Flow identifier -module_resource_id | String | Module identifier -invoking_resource_start_timestamp | Timestamp | Time at which flow started -parent_flow_resource_id | String | Flow Id from which the module was invoked from. This field will only be populated for modules -contact_id | String | The identifier of the contact +invoking_resource_type | String | Can be flow or module. +flow_resource_id | String | Flow identifier. +module_resource_id | String | Module identifier. +invoking_resource_start_timestamp | Timestamp | Time at which flow started. +parent_flow_resource_id | String | Flow Id from which the module was invoked from. This field will only be populated for modules. +contact_id | String | The identifier of the contact. @@ -43 +54 @@ flow_action_id | String | Identifier for action that was executed. An Action is -invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself +invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself. @@ -48,8 +59,8 @@ initiation_method | String | Indicates how the contact was initiated. -flow_language_version | String | Flow language version -invoking_resource_version | String | Version of the contact flow used -bot_id | String | The identifier of the bot -bot_alias_id | String | The alias identifier of the bot that the session was held with -bot_version | String | The version of the bot that the session was held with -bot_locale | String | Language configuration of the bot -bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot -bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot +flow_language_version | String | Flow language version. +invoking_resource_version | String | Version of the contact flow used. +bot_id | String | The identifier of the bot. +bot_alias_id | String | The alias identifier of the bot that the session was held with. +bot_version | String | The version of the bot that the session was held with. +bot_locale | String | Language configuration of the bot. +bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot. +bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot. @@ -57,2 +68,2 @@ bot_conversation_outcome | String | The final state of the conversation. Values: -bot_number_of_conversation_turns | Number | The number of turns that the session took -data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness +bot_number_of_conversation_turns | Number | The number of turns that the session took. +data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness. @@ -68,3 +79,3 @@ Column | Type | Description -event_id | String | This is the primary key of the table. This will be a hash of originating request identifier, session identifier, intent name, and intent level -bot_originating_request_id | String | A unique identifier for a specific bot request -bot_session_id | String | The identifier of the user session that is having the conversation +event_id | String | This is the primary key of the table. This will be a hash of originating request identifier, session identifier, intent name, and intent level. +bot_originating_request_id | String | A unique identifier for a specific bot request. +bot_session_id | String | The identifier of the user session that is having the conversation. @@ -74,6 +85,6 @@ instance_id | String | The identifier of the Amazon Connect instance. -invoking_resource_type | String | Can be flow or module -flow_resource_id | String | Flow identifier -module_resource_id | String | Module identifier -invoking_resource_start_timestamp | Timestamp | Time at which flow started -parent_flow_resource_id | String | Flow identifier from which the module was invoked from. This field will only be populated for modules -contact_id | String | The identifier of the contact +invoking_resource_type | String | Can be flow or module. +flow_resource_id | String | Flow identifier. +module_resource_id | String | Module identifier. +invoking_resource_start_timestamp | Timestamp | Time at which flow started. +parent_flow_resource_id | String | Flow identifier from which the module was invoked from. This field will only be populated for modules. +contact_id | String | The identifier of the contact. @@ -81 +92 @@ action_id | String | Identifier for action that was executed. An Action is a sin -invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself +invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself. @@ -86,9 +97,9 @@ initiation_method | String | Indicates how the contact was initiated. -flow_language_version | String | Flow language version -invoking_resource_version | String | Version of the contact flow used -bot_id | String | The identifier of the bot -bot_alias_id | String | The alias identifier of the bot that the session was held with -bot_version | String | The version of the bot that the session was held with -bot_locale | String | Language configuration of the bot -bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot -bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot -bot_intent_name | String | The name of the intent +flow_language_version | String | Flow language version. +invoking_resource_version | String | Version of the contact flow used. +bot_id | String | The identifier of the bot. +bot_alias_id | String | The alias identifier of the bot that the session was held. with +bot_version | String | The version of the bot that the session was held with. +bot_locale | String | Language configuration of the bot. +bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot. +bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot. +bot_intent_name | String | The name of the intent. @@ -96,2 +107,2 @@ bot_intent_level | Number | The number of intents up to and including the reques -bot_intent_outcome | String | The end state of the intent. Value of Success, Failed, Switched, or Dropped -data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness +bot_intent_outcome | String | The end state of the intent. Value of Success, Failed, Switched, or Dropped. +data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness. @@ -107 +118 @@ Column | Type | Description -event_id | String | This is the primary key of the table. This will be a hash of originating request identifier, session identifier, intent name, intent level, slot name, and slot level +event_id | String | This is the primary key of the table. This will be a hash of originating request identifier, session identifier, intent name, intent level, slot name, and slot level. @@ -109 +120 @@ bot_originating_request_id | String | A unique identifier for a specific bot req -bot_session_id | String | The identifier of the user session that is having the conversation +bot_session_id | String | The identifier of the user session that is having the conversation. @@ -113,6 +124,6 @@ instance_id | String | The identifier of the Amazon Connect instance. -invoking_resource_type | String | Can be flow or module -flow_resource_id | String | Flow identifier -module_resource_id | String | Module identifier -invoking_resource_start_timestamp | Timestamp | Time at which flow started -parent_flow_resource_id | String | Flow identifier from which the module was invoked from. This field will only be populated for modules -contact_id | String | The identifier of the contact +invoking_resource_type | String | Can be flow or module. +flow_resource_id | String | Flow identifier. +module_resource_id | String | Module identifier. +invoking_resource_start_timestamp | Timestamp | Time at which flow started. +parent_flow_resource_id | String | Flow identifier from which the module was invoked from. This field will only be populated for modules. +contact_id | String | The identifier of the contact. @@ -120 +131 @@ action_id | String | Identifier for action that was executed. An Action is a sin -invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself +invoking_resource_published_timestamp | Timestamp | "Creation" or "revision" date of the flow itself. @@ -125,9 +136,9 @@ initiation_method | String | Indicates how the contact was initiated. -flow_language_version | String | Flow language version -invoking_resource_version | String | Version of the contact flow used -bot_id | String | The identifier of the bot -bot_alias_id | String | The alias identifier of the bot that the session was held with -bot_version | String | The version of the bot that the session was held with -bot_locale | String | Language configuration of the bot -bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot -bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot -bot_intent_name | String | The name of the intent +flow_language_version | String | Flow language version. +invoking_resource_version | String | Version of the contact flow used. +bot_id | String | The identifier of the bot. +bot_alias_id | String | The alias identifier of the bot that the session was held with. +bot_version | String | The version of the bot that the session was held with. +bot_locale | String | Language configuration of the bot. +bot_conversation_start_timestamp | Timestamp | The timestamp marking the start of the conversation with the bot. +bot_conversation_end_timestamp | Timestamp | The timestamp marking the end of the conversation with the bot. +bot_intent_name | String | The name of the intent. @@ -135 +146 @@ bot_intent_level | Number | The number of intents up to and including the reques -bot_slot_name | String | The name of the slot +bot_slot_name | String | The name of the slot. @@ -137,3 +148,3 @@ bot_slot_level | Number | The number of slots up to and including the requested -bot_slot_outcome | String | The end state of the slot. Values of Success, Failed, Dropped, or Retry -bot_slot_retry_count | Number | The number of times the bot tried to elicit a response from the user for the slot -data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness +bot_slot_outcome | String | The end state of the slot. Values of Success, Failed, Dropped, or Retry. +bot_slot_retry_count | Number | The number of times the bot tried to elicit a response from the user for the slot. +data_lake_last_processed_timestamp | Timestamp | Timestamp which shows the last time the data lake processed the record. This can include transformation and backfill. This field cannot be used to reliably determine data freshness.