Amazon S3 campos de configuração de entrada de dados

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 5 min. de leitura
  • Descrição dos campos no Amazon S3formulário de configuração de entrada de dados.

    Configuração básica

    Campo Descrição
    Nome Nome da nova entrada de dados. Este campo é obrigatório.
    Descrição Descrição da entrada de dados.
    Executar nos(as) Opção para determinar se um específico deve ser usado MID Serverou um MID Servercluster.

    Este recurso é compatível com Análise de logs de integridadeVersão 26.0.17 - fevereiro de 2023 e posterior, disponível em ServiceNow Store .

    MID

    (Somente quando o. Executar em O campo está definido como MID Server específico)

    MID Serverde qual log os dados Amazon S3foi extraído.
    Nota:
    • Somente é possível selecionar MID Serversque oferecem suporte à autenticação básica. MID ServersQue suportam MTLS não estão listados.
    • O número máximo padrão de logs de streaming de entradas de dados para um único MID Serveré 10. Você pode modificar esse número nas propriedades do MID Server.
    • Se a ingestão de log não estiver habilitada para os selecionados MID Server, Análise de logs de integridadehabilita automaticamente.
    Este campo é obrigatório.
    Cluster do MID Server

    (Somente quando o. Executar em o campo está definido como MID ServerCluster.)

    . MID Servercluster para o qual os dados de log são extraídos.

    A entrada de dados é executada em um único MID Serverno cluster até isso MID Serverfalhas. Em seguida, o sistema move todas as tarefas de entrada de dados para as próximas disponíveis MID Serverno cluster de acordo com a ordem configurada.

    Este recurso é compatível com Análise de logs de integridadeVersão 26.0.17 - fevereiro de 2023 e posterior, disponível em ServiceNow Store .

    Nota:
    • Análise de logs de integridadecompatível somente com failover MID Serverclusters. Nesses clusters, vários MID Serverssão agrupados para proteção de failover. Ao selecionar um cluster no formulário de entrada de dados, o. MID ServerA lista de clusters exibe somente clusters de failover.
    • . MID Servero cluster deve incluir somente MID Serversque oferecem suporte à autenticação básica. O MTLS não é compatível com ingestão de log.
    • A ingestão de log deve estar habilitada para cada MID Serverno cluster. Se a ingestão de log não estiver habilitada para o ativo MID Server, Análise de logs de integridadehabilita automaticamente.
    • O número máximo padrão de logs de streaming de entradas de dados para um único MID Serveré 10. Um cluster passa na validação de capacidade se contiver pelo menos um MID Servercom menos de 10 entradas de dados em execução, mesmo quando isso é feito MID Serverestá inativo.
    Para obter mais informações sobre MID Serverclusters, consulte Configure um cluster do MID Server .

    Este campo é obrigatório.

    Instância do serviço A instância de serviço à qual vincular os dados de log.
    Nota:
    Se não existir nenhuma instância de serviço relevante, Crie um instância de serviço E adicione ICs a ele. Defina o status da nova instância de serviço como Operacional.
    Este campo é obrigatório.

    Os seguintes campos mostram informações somente leitura:

    Campo Descrição
    Status Status da entrada de dados.
    Transporte Protocolo usado para transmitir os dados de log.

    Esta entrada de dados usa Amazon S3para transmitir dados de log para sua instância.

    Contagem de fontes O número de origens de log que esta entrada de dados criou.
    Desativado desde Hora em que a entrada de dados parou ou falhou.
    Hora do último log Hora em que o último log foi transmitido na entrada de dados.
    Mensagem de erro O erro de fluxo.

    Este campo é preenchido automaticamente. Ele é exibido somente quando ocorre um erro de fluxo.

    Tabela 1. Guia de configurações de consulta
    Campo Descrição Exemplo
    De/para Datas e hora de início e término da leitura dos dados.
    • De: Dados mais antigos que esta data e hora não são lidos.
      Nota:
      Definir este valor como uma data passada pode exigir que o sistema leia grandes quantidades de dados, causando congestionamento.
    • Para: Os dados mais recentes que esta data e hora não são lidos. Para dados em tempo real, defina esta data no futuro.
    Este campo é obrigatório.
    A partir de: Agora -1 semana

    Para: 2300-01-01 15:59:59

    Nome do bucket . Amazon S3bucket para fluxo.

    Este campo é obrigatório.

    bucket-s3
    Prefixo Prefixo dos objetos a serem obtidos. A entrada de dados busca somente objetos que começam com este prefixo. Este campo é normalmente usado para buscar somente pastas específicas em um bucket. /only/this/folder/
    Incluir Arquivo ou objeto para incluir quando o sistema realiza a correspondência de padrões. .*inclua-me.*
    Excluir Arquivo ou objeto para excluir quando o sistema realiza a correspondência de padrões. .*pule-me.*
    Tabela 2. Guia Transporte
    Campo Descrição
    Credenciais da AWS Campo que se refere à lista de credenciais da AWS (aws_credentials.list). A lista contém as chaves de acesso secreto e de acesso à AWS.
    Região da AWS A região da AWS em que Amazon S3o bucket está localizado, por exemplo, us-west-1.

    Para obter uma lista de regiões da AWS, consulte https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-regions-availability-zones.html#concepts-regions

    Este campo é obrigatório.

    Configuração avançada

    Tabela 3. Formulário de configuração avançada
    Campo Descrição Valor padrão
    Anônimo Opção para forçar o acesso ao Amazon S3bucket sem credenciais, ignorando as credenciais padrão, se existirem. Falso(a)
    Percorrer Opção para acessar cada diretório no bucket. Falso(a)
    Objeto classificado pela hora da última modificação Opção para buscar objetos se os objetos no bucket forem classificados por tempo. Falso(a)
    Tempo limite de conexão O número de milissegundos de espera antes de atingir o tempo limite ao tentar estabelecer uma conexão à AWS. 100
    Tamanho do Threadpool O número de threads simultâneos que estão baixando arquivos do bucket. 1
    Tamanho do buffer Tamanho do buffer de download, em bytes. 100MB
    Tempo limite do soquete O número de milissegundos de espera antes de atingir o tempo limite ao transferir dados por uma conexão estabelecida. 10000
    Máximo de novas tentativas para o arquivo O número máximo de vezes que é possível repetir o processamento de arquivos em caso de falha. 10
    Fuso horário padrão O fuso horário padrão se o log não incluir informações de fuso horário. UTC
    Proporção de soltura de subamostra O número de eventos a serem agrupados, dos quais um será descartado. Esta configuração é usada para reduzir o número de eventos obtidos. -1
    Taxa de recebimento de subamostra O número de eventos a serem agrupados, dos quais todos, exceto um, serão descartados. Esta configuração é usada para diminuir o número de eventos recebidos. -1
    Limite de taxa O número máximo de eventos por segundo que esta entrada de dados processa. -1
    Tamanho máximo em bytes O tamanho máximo dos eventos, em bytes. 32766
    Codificação de caracteres A codificação de caracteres para esta entrada de dados. UTF-8
    Intervalo de inatividade O intervalo de espera, em segundos, antes de fazer uma nova consulta depois que uma consulta não retornou eventos. 60
    Intervalo de Pesquisa O intervalo de espera, em segundos, antes de pesquisar novos eventos. 0
    Descartar se a fila estiver cheia Opção para selecionar descartar logs se houver uma carga no MID Server. Falso(a)