Gerenciar sua replicação

Esta seção descreve opções adicionais de configuração de replicação disponíveis no S3 no Outposts, como determinar o status da replicação e como solucionar problemas de replicação. Para obter informações sobre a configuração de replicação principal, consulte Configuração da replicação.

Tópicos

• Monitorar o andamento com métricas de replicação
• Obtenção de informações sobre o status da replicação
• Solução de problemas de replicação
• Usar o EventBridge para replicação do S3 no Outposts

Monitorar o andamento com métricas de replicação

A replicação do S3 no Outposts fornece métricas detalhadas para as regras de replicação na configuração de replicação. Com métricas de replicação, você pode monitorar em intervalos de cinco minutos o andamento da replicação rastreando bytes pendentes de replicação, latência de replicação e operações pendentes. Para auxiliar na solução de problemas de configuração, você também pode configurar o Amazon EventBridge para receber notificações sobre falhas de replicação.

Quando métricas de replicação são ativadas, a replicação do S3 no Outposts publica as seguintes métricas no Amazon CloudWatch:

• Bytes pendentes de replicação: o número total de bytes de objetos com replicação pendente para determinada regra de replicação.

• Latência de replicação: o número máximo de segundos pelo qual o bucket de destino da replicação está atrás do bucket de origem para determinada regra de replicação.

• Operações pendentes de replicação: o número de operações pendentes de replicação para determinada regra de replicação. As operações incluem objetos, marcadores de exclusão e tags.

nota

As métricas de replicação do S3 no Outposts são cobradas usando a mesma taxa das métricas personalizadas do CloudWatch. Para obter mais informações, consulte Preço do CloudWatch.

Obtenção de informações sobre o status da replicação

O status da replicação pode ajudar você a determinar o estado atual de um objeto que está sendo replicado pelo Amazon S3 no Outposts. O status de replicação de um objeto de origem retornará PENDINGCOMPLETED, ou FAILED. O status de replicação de uma réplica retornará REPLICA.

Visão geral do status da replicação

Em um cenário de replicação, você tem um bucket de origem em que configura a replicação e um bucket de destino onde o S3 no Outposts replica objetos. Ao solicitar um objeto (usando GetObject) ou metadados de objeto (usando HeadObject) nesses buckets, o S3 no Outposts retornará o cabeçalho x-amz-replication-status na resposta da seguinte maneira:

• Ao solicitar um objeto no bucket de origem, o S3 no Outposts retornará o cabeçalho x-amz-replication-status se o objeto em sua solicitação for qualificado para replicação.

  Por exemplo, suponha que, em sua configuração de replicação, você especifique o prefixo de objeto TaxDocs para dizer ao S3 no Outposts para replicar somente objetos com o prefixo de nome de chave TaxDocs. Todos os objetos dos quais você fizer upload e tiverem esse prefixo de nome de chave, por exemplo, TaxDocs/document1.pdf, serão replicados. Para solicitações de objeto com esse prefixo de nome de chave, o S3 no Outposts retorna o cabeçalho x-amz-replication-status com um dos seguintes valores para o status de replicação do objeto: PENDING, COMPLETED ou FAILED.

  nota

  Se a replicação do objeto falhar depois de você fazer upload de um objeto, não será possível tentar novamente a replicação. É preciso fazer upload do objeto novamente. Os objetos mudam para o estado FAILED em caso de problemas como a ausência das permissões da função de replicação ou do bucket. No caso de falhas temporárias, por exemplo, se um bucket ou uma região não estiver disponível, o status da replicação não fará a transição para FAILED, mas permanecerá PENDING. Depois que o recurso estiver online novamente, o S3 no Outposts retomará a replicação desses objetos.

• Ao solicitar um objeto no bucket de destino, se o objeto de sua solicitação for uma réplica criada pelo S3 no Outposts, o S3 no Outposts retornará o cabeçalho x-amz-replication-status com o valor REPLICA.

nota

Antes de excluir um objeto de um bucket de origem com a replicação habilitada, verifique o status de replicação dele para garantir que o objeto tenha sido replicado.

Status da replicação se a sincronização de modificação de réplica do Amazon S3 no Outposts estiver ativada

Quando suas regras de replicação ativam a sincronização de modificação de réplica do S3, as réplicas podem informar um status diferente de REPLICA. Se alterações de metadados estiverem no processo de replicação, o cabeçalho x-amz-replication-status da réplica retornará PENDING. Se a sincronização de modificação de réplica não replicar os metadados, o cabeçalho da réplica retornará FAILED. Se os metadados forem replicados corretamente, o cabeçalho da réplica retornará o valor REPLICA.

Solução de problemas de replicação

Se as réplicas dos objetos não aparecerem no bucket do Amazon S3 no Outposts de destino depois de configurar a replicação, use estas dicas para identificar e corrigir os problemas.

• O tempo que o S3 no Outposts leva para replicar um objeto depende de vários fatores, incluindo a distância entre o Outposts de origem e destino e o tamanho do objeto.

  Você pode conferir o status de replicação do objeto de origem. Se o status de replicação do objeto for PENDING, o S3 no Outposts não concluiu a replicação. Se o status de replicação do objeto for FAILED, confira a configuração de replicação definida no bucket de origem.

• Na configuração de replicação do bucket de origem, verifique o seguinte:

  • O nome do recurso da Amazon (ARN) do ponto de acesso do bucket de destino está correto.

  • O prefixo do nome de chave está correto. Por exemplo, se você definiu a configuração para replicar objetos com o prefixo Tax, apenas objetos com nomes de chaves como Tax/document1 ou Tax/document2 serão replicados. Um objeto com o nome de chave document3 não será replicado.

  • O status é Enabled.

• Verifique se o versionamento não foi suspenso em nenhum bucket. Tanto o bucket de origem quanto o de destino devem ter o versionamento ativado.

• Se o bucket de destino pertencer a outra Conta da AWS, verifique se o proprietário do bucket tem uma política de bucket no bucket de destino que permita ao proprietário do bucket de origem replicar objetos. Para ver um exemplo, consulte Conceder permissões quando os buckets do Outposts de origem e destino pertencerem a Contas da AWS diferentes.

• Se a réplica do objeto não aparecer no bucket de destino, os seguintes problemas podem ter impedido a replicação:

  • O S3 no Outposts não replica um objeto em um bucket de origem que seja uma réplica criada por outra configuração de replicação. Por exemplo, se você definir uma configuração de replicação do bucket A para o bucket B e para o bucket C, o S3 no Outposts não replicará réplicas de objetos no bucket B para o bucket C.

    Se você quiser replicar objetos no bucket A para o bucket B e o bucket C, defina vários destinos de bucket em diferentes regras de replicação para sua configuração de replicação do bucket de origem. Por exemplo, crie duas regras de replicação no bucket A de origem, com uma regra para replicar no bucket B de destino e a outra regra para replicar no bucket C.

  • O proprietário do bucket de origem pode conceder a outras Contas da AWS permissão para carregar objetos. Por padrão, o proprietário do bucket de origem não tem nenhuma permissão para os objetos criados por outras contas. A configuração de replicação vai replicar somente os objetos para os quais o proprietário do bucket de origem tem permissões de acesso. Para evitar problemas de replicação, o proprietário do bucket de origem pode conceder a outras Contas da AWS permissões para criar objetos condicionalmente, exigindo permissões explícitas de acesso nesses objetos. Para ver um exemplo de política, consulte Conceder permissões entre contas para fazer upload de objetos garantindo que o proprietário do bucket tenha controle total.

• Vamos supor que, na configuração da replicação, você adicione uma regra para replicar um subconjunto de objetos com uma tag específica. Nesse caso, você deve atribuir a chave da tag específica e o valor no momento de criar o objeto para o S3 no Outposts replicar o objeto. Se você primeiro criar um objeto e depois adicionar a tag ao objeto existente, o S3 no Outposts não replicará o objeto.

• A replicação falhará se a política de bucket negar o acesso à função de replicação para qualquer uma das seguintes ações:

  Bucket de origem:

  "s3-outposts:GetObjectVersionForReplication",
  "s3-outposts:GetObjectVersionTagging"

  Buckets de destino:

  "s3-outposts:ReplicateObject",
  "s3-outposts:ReplicateDelete",
  "s3-outposts:ReplicateTags"

• O Amazon EventBridge pode notificar você quando os objetos não forem replicados em seus Outposts de destino. Para obter mais informações, consulte Usar o EventBridge para replicação do S3 no Outposts.