`AWSSupport-CollectAmazonConnectContactFlowLog`

Descrição

O runbook de AWSSupport-CollectAmazonConnectContactFlowLog automação é usado para coletar os registros de fluxo de contatos do Amazon Connect para uma ID de contato específica. Ao fornecer seu ID de instância e ID de contato do Amazon Connect, o runbook pesquisa os registros de fluxo de contatos do grupo de CloudWatch registros da Amazon e os carrega no bucket do Amazon Simple Storage Service (Amazon S3) especificado no parâmetro de solicitação. O runbook gera uma saída que fornece o URL do console Amazon S3 e o comando AWS CLI para você baixar os registros.

Como funciona?

O runbook de AWSSupport-CollectAmazonConnectContactFlowLog automação ajuda a coletar os registros de fluxo de contatos do Amazon Connect para um ID de contato específico armazenado no grupo de CloudWatch registros configurado e os carrega em um bucket específico do Amazon S3. Para ajudar na segurança dos registros coletados do seu fluxo de contatos do Amazon Connect, a automação avalia a configuração do bucket do Amazon S3 para determinar se o bucket concede permissões read públicas write ou de acesso e é de propriedade AWS da conta especificada no S3BucketOwnerAccountId parâmetro. Se seu bucket do Amazon S3 usa criptografia do lado do servidor com AWS Key Management Service chaves (SSE-KMS), certifique-se de que o usuário ou a função AWS Identity and Access Management (IAM) que está executando essa automação tenha as permissões na chave. kms:GenerateDataKey AWS KMS Para obter mais informações sobre os registros gerados pela sua instância do Amazon Connect, consulte Registros de fluxo armazenados em um grupo de CloudWatch registros da Amazon.

Importante

As consultas do CloudWatch Logs Insights incorrem em cobranças com base na quantidade de dados consultados. Os clientes do nível gratuito são cobrados apenas pelo uso que ultrapassar as cotas de serviço. Para obter mais informações, consulte Definição de preço do Amazon CloudWatch.

Executar esta automação (console)

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux, macOS, Windows

Parâmetros

Permissões obrigatórias do IAM

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.



        {
            "Statement": [
                {
                    "Action": [
                        "s3:GetBucketPublicAccessBlock",
                        "s3:GetBucketPolicyStatus",
                        "s3:GetBucketAcl",
                        "s3:GetObject",
                        "s3:GetObjectAttributes",
                        "s3:PutObject",
                        "s3:PutObjectAcl"
                    ],
                    "Resource": [
                    "arn:aws:s3:::amzn-s3-demo-bucket/*",
                    "arn:aws:s3:::amzn-s3-demo-bucket"
                    ],
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "connect:DescribeInstance",
                        "connect:DescribeContact",
                        "ds:DescribeDirectories"
                    ],
                    "Resource": "*",
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "logs:StartQuery",
                        "logs:GetQueryResults"

                    "Resource": "*",
                    "Effect": "Allow"
                }
            ]
        }

Instruções

Siga estas etapas para configurar a automação:

Navegue até AWSSupport-CollectAmazonConnectContactFlowLogem Systems Manager em Documentos.
Selecione Execute automation (Executar automação).
Para os parâmetros de entrada, insira o seguinte:
- AutomationAssumeRole (Opcional):
  
  O Amazon Resource Name (ARN) da função AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhuma função for especificada, o Systems Manager Automation usa as permissões do usuário que inicia esse runbook.
- ConnectInstanceId (Obrigatório):
  
  O ID da sua instância do Amazon Connect.
- ContactId (Obrigatório):
  
  A ID do contato para o qual você deseja coletar o registro do fluxo de contatos.
- S3 BucketName (obrigatório):
  
  O nome do bucket do Amazon S3 na sua conta em que você deseja fazer o upload do log de fluxo de contatos. Certifique-se de que a política de bucket não conceda permissões desnecessárias de leitura/gravação a partes que não precisam acessar os registros coletados.
- S3 ObjectPrefix (opcional):
  
  O caminho do objeto do Amazon S3 no bucket do Amazon S3 para um log de fluxo de contatos carregado. Por exemplo, se você especificarCollectedLogs, o registro será carregado comos3://your-s3-bucket/CollectedLogs/ContactFlowLog_[ContactId][AWSAccountId].gz. Se você não especificar esse parâmetro, o ID de execução do Systems Manager Automation será usado, por exemplo:s3://your-s3-bucket/[automation:EXECUTION_ID]/ContactFlowLog[ContactId]_[AWSAccountId].gz. Observação: se você especificar um valor S3ObjectPrefix e executar essa automação usando o mesmo [ContactId], o registro do fluxo de contatos será sobrescrito.
- S3 BucketOwnerAccount (opcional):
  
  O número da AWS conta que possui o bucket do Amazon S3 em que você deseja fazer o upload do log de fluxo de contatos. Se você não especificar esse parâmetro, o runbook usará o ID da AWS conta do usuário ou da função na qual a automação é executada.
- S3 BucketOwnerRoleArn (opcional):
  
  O ARN da função do IAM com permissões para obter o bucket e a conta do Amazon S3 bloqueia as configurações de acesso público, a configuração da criptografia do bucket, o ACLs bucket, o status da política do bucket e carrega objetos no bucket. Se esse parâmetro não for especificado, o runbook usa o AutomationAssumeRole (se especificado) ou o usuário que inicia esse runbook (se não AutomationAssumeRole for especificado). Veja a seção de permissões necessárias na descrição do runbook.
Selecione Executar.
A automação é iniciada.
O bucket realiza as seguintes etapas:
- CheckConnectInstanceExistance
  
  Verifica se a instância do Amazon Connect fornecida no ConnectInstanceId éACTIVE.
- Verificações 3 BucketPublicStatus
  
  Verifica se o bucket do Amazon S3 especificado em S3BucketName permite permissões de acesso anônimas ou públicas de leitura ou gravação.
- GenerateLogSearchTimeRange
  
  Gera StartTime e EndTime para a StartQuery etapa com base na InitiationTimestamp e LastUpdateTimestamp retornada pela DescribeContact API. StartTimeserá uma hora antes InitiationTimestamp e EndTime será uma hora depoisLastUpdateTimestamp.
- StartQuery
  
  Inicia um registro de consulta para o fornecido ContactId no grupo de CloudWatch registros de registros associado à instância do Amazon Connect fornecida emConnectInstanceId. As consultas atingem o tempo limite após 60 minutos de tempo de execução. Se sua consulta atingir o tempo limite, reduza o intervalo de tempo pesquisado. Você pode ver as consultas atualmente em andamento, bem como seu histórico de consultas recentes no CloudWatch console. Para obter mais informações, consulte Exibir consultas em execução ou histórico de consultas.
- WaitForQueryCompletion
  
  Aguarda a conclusão do registro de consultas de CloudWatch registros para que o fornecido seja ContactId concluído. Observe que a consulta expira após 60 minutos de tempo de execução. Se sua consulta atingir o tempo limite, reduza o intervalo de tempo pesquisado. Você pode visualizar as consultas atualmente em andamento, bem como seu histórico de consultas recentes no console do Amazon Connect. Para obter mais informações, consulte Exibir consultas em execução ou histórico de consultas.
- UploadContactFlowLog
  
  Obtém o resultado da consulta e carrega o log do fluxo de contatos para o bucket do Amazon S3 especificado em. S3BucketName
- GenerateReport
  
  Retorna a URL do console Amazon S3 em que o log do fluxo de contatos foi carregado e um exemplo de comando AWS CLI que você pode usar para baixar o arquivo de log.
Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução:
- GenerateReport.OutputPayload
  
  Saída que informa que o runbook recuperou com sucesso os registros de fluxo de contato do contato especificado. Esse relatório também contém a URL do console Amazon S3 e um exemplo de comando da AWS CLI para que você possa baixar o arquivo de log.

Referências

Automação do Systems Manager

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

AWS Directory Service