Monitorando seu gateway de arquivos S3, gateway de - AWS Storage Gateway
Obtendo registros de integridade do S3 File Gateway FSx Usando CloudWatch métricas da AmazonReceber notificação sobre operações de arquivoNoções básicas de métricas de gatewayNoções básicas de métricas de compartilhamento de arquivosCompreendendo os registros de auditoria do S3 File Gateway FSx

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitorando seu gateway de arquivos S3, gateway de

Você pode monitorar o gateway de arquivos do S3 FSx e os recursos associados AWS Storage Gateway usando CloudWatch métricas e registros de auditoria da Amazon. Você também pode usar CloudWatch Eventos para ser notificado quando suas operações de arquivo forem concluídas.

Obtendo registros de integridade do S3 FSx File Gateway com grupos CloudWatch de registros

Você pode usar o Amazon CloudWatch Logs para obter informações sobre a integridade do seu gateway de arquivos do S3 e recursos relacionados. É possível usar os logs para monitorar o gateway em busca de erros encontrados. Além disso, você pode usar filtros de CloudWatch assinatura da Amazon para automatizar o processamento das informações de log em tempo real. Para obter mais informações, consulte Processamento em tempo real de dados de log com assinaturas no Guia CloudWatch do usuário da Amazon.

Por exemplo, você pode configurar um grupo de CloudWatch logs para monitorar seu gateway e ser notificado quando o S3 File Gateway falhar ao fazer upload de arquivos para um bucket do Amazon S3. É possível configurar o grupo quando estiver ativando o gateway ou depois que ele estiver ativado e em execução. Para obter informações sobre como configurar um grupo de CloudWatch registros ao ativar um gateway, consulteConfigurar o Gateway de Arquivos do Amazon S3. Para obter informações gerais sobre grupos de CloudWatch registros, consulte Como trabalhar com grupos de registros e fluxos de registros no Guia do CloudWatch usuário da Amazon.

Veja a seguir um exemplo de erro relatado pelo Gateway de Arquivos do S3. 

{
    "severity": "ERROR",
    "bucket": "bucket-smb-share2",
    "roleArn": "arn:aws:iam::123456789012:role/amzn-s3-demo-bucket",
    "source": "share-E1A2B34C",
    "type": "InaccessibleStorageClass",
    "operation": "S3Upload",
    "key": "myFolder/myFile.text",
    "gateway": "sgw-B1D123D4",
    "timestamp": "1565740862516"
}

Esse erro significa que o Gateway de Arquivos do S3 não consegue fazer upload do objeto myFolder/myFile.text para o Amazon S3 porque ele mudou da classe de armazenamento Amazon S3 Standard para a classe de armazenamento S3 Glacier Deep Archive.

No log de integridade do gateway anterior, estes itens especificam as informações fornecidas:

  • source: share-E1A2B34C indica o compartilhamento de arquivos que encontrou esse erro.

  • "type": "InaccessibleStorageClass" indica o tipo de erro que ocorreu. Nesse caso, esse erro foi encontrado quando o gateway estava tentando fazer upload do objeto especificado para o Amazon S3 ou ler do Amazon S3. No entanto, nesse caso, o objeto passou para o Amazon Glacier. O valor de "type" pode ser qualquer erro que o Gateway de Arquivos do S3 encontre. Para obter uma lista de possíveis erros, consulte Solução de problemas: problemas no Gateway de Arquivos.

  • "operation": "S3Upload" indica que esse erro ocorreu quando o gateway estava tentando fazer upload desse objeto para o S3.

  • "key": "myFolder/myFile.text" indica o objeto que causou a falha.

  • gateway": "sgw-B1D123D4 indica o Gateway de Arquivos do S3 que encontrou esse erro.

  • "timestamp": "1565740862516" indica a hora em que o erro ocorreu.

Para obter informações sobre como solucionar os erros que podem ser relatados pelo S3 File Gateway , consulte. Solução de problemas: problemas no Gateway de Arquivos

Configurando um grupo de CloudWatch registros após a ativação do gateway

O procedimento a seguir mostra como configurar um grupo de CloudWatch registros após a ativação do gateway.

Para configurar um grupo de CloudWatch registros para trabalhar com seu S3 File Gateway Gateway

  1. Faça login Console de gerenciamento da AWS e abra o console do Storage Gateway em https://console.aws.amazon.com/storagegateway/casa.

  2. No painel de navegação, escolha Gateways e, em seguida, escolha o gateway para o qual você deseja configurar o grupo de CloudWatch registros.

  3. Em Ações, selecione Editar informações do gateway.

  4. Em Escolher como configurar o grupo de logs, escolha uma das seguintes opções:

    • Crie um novo grupo de registros para criar um novo grupo de CloudWatch registros.

    • Use um grupo de registros existente para usar um grupo de CloudWatch registros que já existe.

      Escolha um grupo de logs na Lista de grupos de logs existentes.

    • Desative o registro se você não quiser monitorar seu gateway usando grupos de CloudWatch registros.

  5. Escolha Salvar alterações.

  6. Para obter os logs de integridade do gateway, faça o seguinte:

    1. No painel de navegação, escolha Gateways e, em seguida, escolha o gateway para o qual você configurou o grupo de CloudWatch registros.

    2. Escolha a guia Detalhes e, em Health logs, escolha CloudWatchLogs. A página de detalhes do grupo de registros é aberta no CloudWatch console.

Usando CloudWatch métricas da Amazon

Você pode obter dados de monitoramento para o gateway de arquivos do S3 FSx usando a API Console de gerenciamento da AWS ou a CloudWatch API. O console exibe uma série de gráficos com base nos dados brutos da CloudWatch API. A CloudWatch API também pode ser usada por meio de uma das ferramentas AWS SDKsde CloudWatch API da Amazon. Dependendo das necessidades, você pode preferir usar os gráficos exibidos no console ou recuperados da API.

Independentemente do método que você usar para trabalhar com métricas, deverá especificar as seguintes informações:

  • A dimensão da métrica com a qual trabalhará. Uma dimensão é um par nome/valor, que ajuda a identificar com exclusividade uma métrica. As dimensões do Storage Gateway são GatewayId e GatewayName. No CloudWatch console, você pode usar a Gateway Metrics visualização para selecionar dimensões específicas do gateway. Para obter mais informações sobre dimensões, consulte Dimensões no Guia do CloudWatch usuário da Amazon.

  • O nome da métrica, como ReadBytes.

A tabela a seguir resume que tipo de dados de métrica do Storage Gateway estão disponíveis.

CloudWatch Namespace Amazon Dimensão Description
AWS/StorageGateway GatewayId, GatewayName

Essas dimensões filtram dados de métrica que descrevem aspectos do gateway. Você pode identificar um gateway de arquivos do S3 FSx com o qual trabalhar especificando as dimensões GatewayId e asGatewayName.

Os dados de taxa de transferência e latência de um gateway baseiam-se em todos os compartilhamentos de arquivos no gateway.

Os dados são disponibilizados automaticamente em períodos de cinco minutos, sem custo adicional.

Trabalhar com métricas de gateway e de arquivo é semelhante a trabalhar com outras métricas de serviço. Você pode encontrar uma discussão sobre algumas das tarefas mais comuns relacionadas a métricas na documentação do CloudWatch listada a seguir:

Receber notificação sobre operações de arquivo

O Storage Gateway pode iniciar os seguintes CloudWatch eventos quando suas operações de arquivo forem concluídas:

  • Você pode ser notificado quando o gateway terminar o upload assíncrono de seus arquivos do compartilhamento de arquivos para o Amazon S3. Use o parâmetro NotificationPolicy para solicitar uma notificação de upload de arquivo. Isso envia uma notificação para cada upload de arquivo concluído para o Amazon S3. Para obter mais informações, consulte Receber notificação do upload de arquivos.

  • Você pode ser notificado quando o gateway terminar o upload assíncrono do conjunto de arquivos em uso do compartilhamento de arquivos para o Amazon S3. Use a operação da NotifyWhenUploadedAPI para solicitar uma notificação de upload de um conjunto de arquivos em funcionamento. Isso envia uma notificação quando é feito upload de todos os arquivos do conjunto de arquivos de trabalho para o Amazon S3. Para obter mais informações, consulte Receber notificação de upload do conjunto de arquivos em uso.

  • Você pode ser notificado quando o gateway terminar de atualizar o cache para seu bucket do S3. Ao invocar a RefreshCacheoperação por meio do console ou da API do Storage Gateway, assine a notificação quando a operação for concluída. Para obter mais informações, consulte Receber notificação de atualização do cache.

Quando a operação de arquivo solicitada estiver concluída, o Storage Gateway enviará uma notificação por meio de CloudWatch Eventos. Você pode configurar CloudWatch Eventos para enviar a notificação por meio de destinos de eventos, como Amazon SNS, Amazon SQS ou uma função. AWS Lambda Por exemplo, você pode configurar um destino do Amazon SNS para enviar a notificação aos consumidores do Amazon SNS, como e-mails e mensagens de texto. Para obter informações sobre CloudWatch eventos, consulte O que são CloudWatch eventos?

Para configurar a notificação de CloudWatch eventos

  1. Crie um destino, como um tópico do Amazon SNS ou uma função do Lambda, para invocar quando o evento solicitado no Storage Gateway ocorrer.

  2. Crie uma regra no console de CloudWatch Eventos para invocar destinos com base em um evento no Storage Gateway.

  3. Na regra, crie um padrão de evento para o tipo de evento. A notificação é enviada quando o evento corresponde a esse padrão de regra.

  4. Selecione o destino e defina as configurações.

O exemplo a seguir mostra uma regra que inicia o tipo de evento especificado no gateway especificado e na AWS região especificada. Por exemplo, você pode especificar Storage Gateway File Upload Event como o tipo de evento.

{
   "source":[
      "aws.storagegateway"
   ],
   "resources":[
      "arn:aws:storagegateway:AWS Region:account-id
                 :gateway/gateway-id"
   ],
   "detail-type":[
      "Event type"
   ]
}

Para obter informações sobre como usar as regras de CloudWatch eventos, consulte Criação de uma regra de CloudWatch eventos que é acionada em um evento no Guia do usuário do Amazon CloudWatch Events.

Receber notificação do upload de arquivos

Há dois casos de uso para os quais você pode utilizar a notificação de upload de arquivos:

  • Para automatizar o processamento em nuvem do upload de arquivos, você pode chamar o parâmetro NotificationPolicy e receber um ID de notificação. A notificação que ocorre quando os arquivos dos quais é feito upload tem o mesmo ID de notificação que o dos exibidos pela API. Se você associar esse ID de notificação para monitorar a lista de arquivos dos quais está fazendo upload, você poderá iniciar o processamento do arquivo cujo upload foi feito para a AWS quando o evento com o mesmo ID for gerado.

  • Para casos de uso de distribuição de conteúdo, você pode ter dois Gateways de Arquivos do S3 associados ao mesmo bucket do Amazon S3. O cliente de compartilhamento de arquivos do Gateway1 pode fazer upload de novos arquivos para o Amazon S3 e os arquivos são lidos por clientes de compartilhamento de arquivos no Gateway2. Será feito upload dos arquivos para o Amazon S3, mas eles não ficarão visíveis no Gateway2, pois este usa uma versão localmente armazenada em cache dos arquivos no Amazon S3. Para tornar os arquivos visíveis no Gateway2, é possível usar o parâmetro NotificationPolicy para solicitar que a notificação de upload de arquivos do Gateway1 envie uma notificação para você quando o upload estiver concluído. Em seguida, você pode usar CloudWatch Eventos para emitir automaticamente uma RefreshCachesolicitação para o compartilhamento de arquivos no Gateway2. Quando a RefreshCachesolicitação for concluída, o novo arquivo ficará visível no Gateway2.

exemplo Exemplo: notificação de upload de arquivos

O exemplo a seguir mostra uma notificação de upload de arquivo que é enviada CloudWatch quando o evento corresponde à regra que você criou. Esta notificação está no formato JSON. Você pode configurar essa notificação para ser entregue à mensagem de destino como texto. O detail-type é Storage Gateway Object Upload Event.

{
    "version": "0",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Object Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2020-11-05T12:34:56Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:storagegateway:us-east-1:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-1:123456789011:gateway/sgw-712345DA",
        "arn:aws:s3:::do-not-delete-bucket"
    ],
    "detail": {
        "object-size": 1024,
        "modification-time": "2020-01-05T12:30:00Z",
        "object-key": "my-file.txt",
        "event-type": "object-upload-complete",        
        "prefix": "prefix/",
        "bucket-name": "amzn-s3-demo-bucket",  
    }
}

Nomes de campos

Description

version

A versão atual da política do IAM.

id

O ID que identifica a política do IAM.

detail-type

Uma descrição do evento que iniciou a notificação enviada.

origem

O AWS serviço que é a fonte da solicitação e da notificação.

conta

O ID da AWS conta da qual a solicitação e a notificação foram geradas.

horário

O horário em que a solicitação para fazer upload de arquivos para o Amazon S3 foi feita.

região

A AWS região de onde a solicitação e a notificação foram enviadas.

recursos

Os recursos do Storage Gateway aos quais a política se aplica.

tamanho do objeto

O tamanho do objeto em bytes.

modification-time

A hora em que o cliente modificou o arquivo.

object-key

O caminho para a função .

event-type

Os CloudWatch eventos que iniciaram a notificação.

prefix

O nome do prefixo do bucket do S3.

nome-do-seu-bucket

O nome do bucket do S3.

Receber notificação de upload do conjunto de arquivos em uso

Há dois casos de uso para os quais você pode utilizar a notificação de upload do conjunto de arquivos de trabalho:

  • Para automatizar o processamento em nuvem de arquivos cujo upload foi feito, você pode chamar a API NotifyWhenUploaded e receber um ID de notificação. A notificação que ocorre quando o conjunto de arquivos em uso do qual é feito upload tem o mesmo ID de notificação daquele exibido pela API. Se você mapear esse ID de notificação para rastrear a lista de arquivos que você está carregando, poderá iniciar o processamento do conjunto de trabalho de arquivos que são enviados AWS quando o evento com o mesmo ID for gerado.

  • Para casos de uso de distribuição de conteúdo, você pode ter dois Gateways de Arquivos do S3 associados ao mesmo bucket do Amazon S3. O cliente de compartilhamento de arquivos do Gateway1 pode fazer upload de novos arquivos para o Amazon S3 e os arquivos são lidos por clientes de compartilhamento de arquivos no Gateway 2. Será feito upload dos arquivos para o Amazon S3, mas eles não ficarão visíveis no Gateway2, pois este usa uma versão localmente armazenada em cache dos arquivos no S3. Para tornar os arquivos visíveis no Gateway2, use a operação de NotifyWhenUploadedAPI para solicitar uma notificação de upload de arquivo do Gateway1, para notificá-lo quando o upload do conjunto de arquivos de trabalho estiver concluído. Em seguida, você pode usar os CloudWatch Eventos para emitir automaticamente uma RefreshCachesolicitação para o compartilhamento de arquivos no Gateway2. Quando a RefreshCachesolicitação for concluída, os novos arquivos ficarão visíveis no Gateway2. Essa operação não importa arquivos para o armazenamento em cache do gateway. Ela atualiza apenas o inventário em cache para refletir as alterações no inventário dos objetos no bucket do S3.

exemplo Exemplo: notificação de upload do conjunto arquivos em uso

O exemplo a seguir mostra uma notificação de upload de um conjunto de arquivos em funcionamento que é enviada CloudWatch quando o evento corresponde à regra que você criou. Esta notificação está no formato JSON. Você pode configurar essa notificação para ser entregue à mensagem de destino como texto. O detail-type é Storage Gateway File Upload Event.

{
    "version": "2012-10-17", 		 	 	 
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway File Upload Event",
    "source": "aws.storagegateway",
    "account": "123456789012",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "upload-complete",
        "notification-id": "11b3106b-a18a-4890-9d47-a1a755ef5e47",
        "request-received": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z"
    }
}

Nomes de campos

Description

version

A versão atual da política do IAM.

id

O ID que identifica a política do IAM.

detail-type

Uma descrição do evento que iniciou a notificação enviada.

origem

O AWS serviço que é a fonte da solicitação e da notificação.

conta

O ID da AWS conta da qual a solicitação e a notificação foram geradas.

horário

O horário em que a solicitação para fazer upload de arquivos para o Amazon S3 foi feita.

região

A AWS região de onde a solicitação e a notificação foram enviadas.

recursos

Os recursos do Storage Gateway aos quais a política se aplica.

event-type

Os CloudWatch eventos que iniciaram a notificação.

notification-id

O ID gerado aleatoriamente da notificação que foi enviada. Esse ID está no formato UUID. Esse é o ID da notificação que é retornada quando NotifyWhenUploaded é chamado.

request-received

O horário em que o gateway recebeu a solicitação NotifyWhenUploaded.

completed

Quando o upload de todos os arquivos no conjunto de trabalho foi feito para o Amazon S3.

Receber notificação de atualização do cache

Para o caso de uso de notificação de atualização do cache, é possível ter dois Gateways de Arquivos do S3 associados ao mesmo bucket do Amazon S3, e o cliente NFS para Gateway1 faz upload dos novos arquivos para o bucket do S3. É feito upload dos arquivos para o Amazon S3, mas eles não serão exibidos no Gateway2 enquanto não atualizar o cache. Isso ocorre porque o Gateway2 usa uma versão armazenada localmente em cache dos arquivos no Amazon S3. Você pode querer fazer algo com os arquivos no Gateway2 quando a atualização do cache é concluída. Arquivos grandes podem demorar para serem exibidos no Gateway2. Portanto, convém optar por ser notificado quando a atualização do cache for concluída. Você pode solicitar uma notificação de atualização do cache do Gateway2 quando todos os arquivos estiverem visíveis nele.

exemplo Exemplo: notificações de atualização do cache

O exemplo a seguir mostra uma notificação de atualização do cache que é enviada CloudWatch quando o evento corresponde à regra que você criou. Esta notificação está no formato JSON. Você pode configurar essa notificação para ser entregue à mensagem de destino como texto. O detail-type é Storage Gateway Refresh Cache Event.

{
    "version": "2012-10-17", 		 	 	 
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Refresh Cache Event",
    "source": "aws.storagegateway",
    "account": "209870788375",
    "time": "2017-11-06T21:34:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
        "arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
    ],
    "detail": {
        "event-type": "refresh-complete",
        "notification-id": "1c14106b-a18a-4890-9d47-a1a755ef5e47",
        "started": "2018-02-06T21:34:42Z",
        "completed": "2018-02-06T21:34:53Z",
        "folderList": [
            "/"
        ]
    }
}

Nomes de campos

Description

version

A versão atual da política do IAM.

id

O ID que identifica a política do IAM.

detail-type

Uma descrição do tipo de evento que iniciou a notificação enviada.

origem

O AWS serviço que é a fonte da solicitação e da notificação.

conta

O ID da AWS conta da qual a solicitação e a notificação foram geradas.

horário

O horário em que a solicitação para atualizar os arquivos no conjunto de trabalho foi feita.

região

A AWS região de onde a solicitação e a notificação foram enviadas.

recursos

Os recursos do Storage Gateway aos quais a política se aplica.

event-type

Os CloudWatch eventos que iniciaram a notificação.

notification-id

O ID gerado aleatoriamente da notificação que foi enviada. Esse ID está no formato UUID. Esse é o ID da notificação que é retornada quando você chama RefreshCache.

started

O horário em que o gateway recebeu a solicitação RefreshCache e a atualização foi iniciada.

completed

O horário em que a atualização do conjunto de trabalho foi concluída.

folderList

Uma lista separada por vírgulas de caminhos de pastas que foram atualizadas no cache. O padrão é ["/"].

Noções básicas de métricas de gateway

A tabela a seguir descreve métricas que abrangem Gateways de Arquivos do S3. Cada gateway tem um conjunto de métricas associadas a ele. Algumas métricas específicas do gateway têm o mesmo nome de determinadas métricas. file-share-specific Essas métricas representam medições do mesmo tipo, mas são dimensionadas para o gateway, não para o sistema de arquivos.

Sempre especifique se deseja trabalhar com um gateway ou um compartilhamento de arquivos ao trabalhar com uma métrica específica. Especificamente, ao trabalhar com métricas do gateway, você deve especificar o Gateway Name para o gateway cujos dados de métrica você deseja visualizar. Para obter mais informações, consulte Usando CloudWatch métricas da Amazon.

nota

Algumas métricas retornam pontos de dados somente quando novos dados são gerados durante o período de monitoramento mais recente.

A tabela a seguir descreve as métricas que você pode usar para obter informações sobre o S3 File Gateway s.

Métrica Description
AuditNotifications

Essa métrica relata o número de logs de auditoria emitidos.

Unidades: contagem
AvailabilityNotifications

Essa métrica relata o número de notificações de integridade relacionadas à disponibilidade que foram geradas pelo gateway no período do relatório.

Unidades: contagem
CacheFileSize

Essa métrica monitora o tamanho dos arquivos no cache do gateway.

Use essa métrica com a estatística Average para medir o tamanho médio de um arquivo no cache do gateway. Use essa métrica com a estatística Max para medir o tamanho máximo de um arquivo no cache do gateway.

Unidades: bytes
CacheFree

Essa métrica relata o número de bytes disponíveis no cache do gateway.

Unidades: bytes
CacheHitPercent

Porcentagem de operações de leitura da aplicação do gateway que são feitas pelo cache. A amostra é capturada no final do período do relatório.

Quando não há operações de leitura da aplicação do gateway, essa métrica relata 100%.

Unidades: percentual
CachePercentDirty

A porcentagem geral do cache do gateway que não persistiu. AWS A amostra é capturada no final do período do relatório.

Use essa métrica com a estatística Sum.

Preferencialmente, essa métrica deve permanecer baixa.

Unidades: percentual
CachePercentUsed

A porcentagem do cache de dados usado em todo o gateway. A amostra é capturada no final do período do relatório.

Unidades: percentual
CacheUsed

Essa métrica relata o número de bytes utilizados no cache do gateway.

Unidades: bytes
CloudBytesDownloaded

O número total de bytes dos quais o gateway foi baixado AWS durante o período do relatório.

Use essa métrica com a estatística Sum para medir a taxa de transferência e com a estatística Samples para medir IOPS.

Unidades: bytes
CloudBytesUploaded

O número total de bytes para os quais o gateway foi carregado AWS durante o período do relatório.

Use essa métrica com a Sum estatística para medir a taxa de transferência e com a Samples estatística para medir as input/output operações por segundo (IOPS).

Unidades: bytes
FilesFailingUpload

Essa métrica monitora o número de arquivos cujo upload não está sendo feito para a AWS. Esses arquivos vão gerar notificações de integridade que contêm mais informações sobre o problema.

Use essa métrica com a estatística Sum para mostrar o número de arquivos cujo upload não está sendo feito para a AWS no momento.

Unidades: contagem
FileSharesUnavailable

Essa métrica fornece o número de compartilhamentos de arquivos nesses gateways que estão no estado Indisponível.

Se essa métrica informar que algum compartilhamento de arquivo não está disponível, é provável que haja um problema com o gateway que esteja causando interrupções no seu fluxo de trabalho. É recomendável criar um alarme para quando essa métrica informa um valor diferente de zero.

Unidades: contagem
FilesRenamed

Essa métrica monitora o número de arquivos renomeados no período do relatório.

Unidades: contagem
HealthNotifications

Essa métrica relata o número de notificações de integridade que foram geradas pelo gateway no período do relatório.

Unidades: contagem
IndexEvictions

Essa métrica informa o número de arquivos cujos metadados foram removidos do índice de metadados de arquivos armazenado em cache para liberar espaço para novas entradas. O gateway mantém esse índice de metadados, que é preenchido a partir da AWS nuvem sob demanda.

Unidades: contagem
IndexFetches

Essa métrica informa o número de arquivos para os quais os metadados foram recuperados. O gateway mantém um índice em cache dos metadados do arquivo, que é preenchido a partir da AWS nuvem sob demanda.

Unidades: contagem
IoWaitPercent

Essa métrica informa a porcentagem de tempo que a CPU está aguardando uma resposta do disco local.

Unidades: percentual
MemTotalBytes

Essa métrica relata a quantidade total de memória no gateway.

Unidades: bytes
MemUsedBytes

Essa métrica relata a quantidade de memória usada no gateway.

Unidades: bytes
NfsSessions

Essa métrica relata o número de sessões NFS que estão ativas no gateway.

Unidades: contagem
RootDiskFreeBytes

Essa métrica relata o número de bytes disponíveis no disco raiz do gateway.

Se essa métrica indicar que menos de 20 GB estão livres, você deverá aumentar o tamanho do disco raiz.

Para isso, você pode aumentar o tamanho do disco raiz existente na VM. Quando a VM é reinicializada, o gateway reconhece o tamanho aumentado no disco raiz.

Unidades: bytes
S3GetObjectRequestTime

Essa métrica relata o tempo necessário para o gateway concluir as solicitações de recuperação de objetos do S3.

Unidade: milissegundos
S3PutObjectRequestTime

Essa métrica relata o tempo necessário para o gateway concluir as solicitações de colocação de objetos do S3.

Unidade: milissegundos
S3UploadPartRequestTime

Essa métrica relata o tempo necessário para o gateway concluir as solicitações de upload de partes do S3.

Unidade: milissegundos
SmbV1Sessions

Essa métrica relata o número de SMBv1 sessões que estão ativas no gateway.

Unidades: contagem
SmbV2Sessions

Essa métrica relata o número de SMBv2 sessões que estão ativas no gateway.

Unidades: contagem
SmbV3Sessions

Essa métrica relata o número de SMBv3 sessões que estão ativas no gateway.

Unidades: contagem
TotalCacheSize

Essa métrica relata o tamanho total do cache.

Unidades: bytes
UserCpuPercent

Essa métrica relata a porcentagem de tempo gasto no processamento do gateway.

Unidades: percentual

Noções básicas de métricas de compartilhamento de arquivos

Veja a seguir informações sobre as métricas do Storage Gateway que abrangem compartilhamentos de arquivos. Cada compartilhamento de arquivos tem um conjunto de métricas associado a ele. Algumas métricas específicas ao compartilhamento de arquivos têm o mesmo nome que determinadas métricas específicas ao gateway. Essas métricas representam medições do mesmo tipo, mas são dimensionadas para compartilhamento de arquivos.

Você sempre deve especificar se deseja trabalhar com uma métrica de gateway ou de compartilhamento de arquivos, antes de trabalhar com métricas. Mais especificamente, ao trabalhar com métricas de compartilhamento de arquivos, é necessário especificar File share ID, que identifica o compartilhamento de arquivos cujas métricas você tem interesse em visualizar. Para obter mais informações, consulte Usando CloudWatch métricas da Amazon.

nota

Algumas métricas retornam pontos de dados somente quando novos dados são gerados durante o período de monitoramento mais recente.

A tabela a seguir descreve as métricas do Storage Gateway que podem ser usadas para acessar informações sobre os compartilhamentos de arquivos.

Métrica Description
CacheHitPercent

Porcentagem de operações de leitura da aplicação dos compartilhamentos de arquivos que são feitas pelo cache. A amostra é capturada no final do período do relatório.

Quando não há operações de leitura da aplicação do compartilhamento de arquivos, essa métrica relata 100%.

Unidades: percentual
CachePercentDirty

A contribuição do compartilhamento de arquivos para o percentual geral do cache do gateway não mantido na AWS. A amostra é capturada no final do período do relatório.

Use essa métrica com a estatística Sum.

Preferencialmente, essa métrica deve permanecer baixa.

nota

Use a métrica CachePercentDirty do gateway para visualizar o percentual geral do cache do gateway que não é mantido na AWS.

Unidades: percentual
CachePercentUsed

A porcentagem do cache de dados usado em todo o gateway. A amostra é capturada no final do período do relatório. Essa métrica específica do compartilhamento de arquivos relata o mesmo valor que a métrica específica do gateway correspondente.

Unidades: percentual
CloudBytesUploaded

O número total de bytes para os quais o gateway foi carregado AWS durante o período do relatório.

Use essa métrica com a estatística Sum para medir a taxa de transferência e com a estatística Samples para medir IOPS.

Unidades: bytes
CloudBytesDownloaded

O número total de bytes dos quais o gateway foi baixado AWS durante o período do relatório.

Use essa métrica com a Sum estatística para medir a taxa de transferência e com a Samples estatística para medir as input/output operações por segundo (IOPS).

Unidades: bytes
FilesFailingUpload

Essa métrica monitora o número de arquivos cujo upload não está sendo feito para a AWS. Esses arquivos vão gerar notificações de integridade que contêm mais informações sobre o problema.

Use essa métrica com a estatística Sum para mostrar o número de arquivos cujo upload não está sendo feito para a AWS no momento.

Unidades: contagem
ReadBytes

O número total de bytes lidos das aplicações on-premises no período do relatório.

Use essa métrica com a estatística Sum para medir a taxa de transferência e com a estatística Samples para medir IOPS.

Unidades: bytes
WriteBytes

O número total de bytes gravados nos aplicativos locais no período do relatório.

Use essa métrica com a estatística Sum para medir a taxa de transferência e com a estatística Samples para medir IOPS.

Unidades: bytes

Compreendendo os registros de auditoria do S3 File Gateway FSx

Os logs de auditoria do Gateway de Arquivos do Amazon S3 (Gateway de Arquivos do S3) fornecem detalhes sobre o acesso do usuário a arquivos e pastas em um compartilhamento de arquivos. É possível usá-los para monitorar as atividades do usuário e tomar medidas se forem identificados padrões de atividade inadequados.

Operações

A tabela a seguir descreve as operações de acesso ao arquivo de log de auditoria do S3 FSx File Gateway.

Nome da operação

Definição

Ler dados

Leia o conteúdo de um arquivo.

Gravar dados

Altere o conteúdo de um arquivo.

Criar

Crie um novo arquivo ou pasta.

Renomear

Renomeie um arquivo ou pasta existente.

Delete

Exclua um arquivo ou uma pasta.

Atributos de gravação

Atualize os metadados do arquivo ou da pasta (proprietárioACLs, grupo, permissões).

Atributos.

A tabela a seguir descreve os atributos de acesso ao arquivo de log de auditoria do Gateway de Arquivos do S3.

Atributo

Definição
accessMode A configuração de permissão do objeto.
accountDomain(somente SMB) O domínio do Active Directory (AD) ao qual pertence a conta do cliente.
accountName (somente SMB) O nome de usuário do cliente do Active Directory.
bucket O nome de um bucket do S3.
clientGid (somente NFS) O identificador do grupo do usuário que está acessando o objeto.
clientUid (somente NFS) O identificador do usuário que está acessando o objeto.
ctime A hora em que o conteúdo ou os metadados do objeto foram modificados, definida pelo cliente.
groupId O identificador do proprietário do grupo do objeto.
fileSizeInBytes O tamanho do arquivo em bytes, definido pelo cliente no momento da criação do arquivo.
gateway O ID do Storage Gateway.
mtime A hora em que o conteúdo do objeto foi modificado, definida pelo cliente.
newObjectName O caminho completo para o novo objeto depois que ele foi renomeado.
objectName O caminho completo para o objeto.
objectType Define se o objeto é um arquivo ou uma pasta.
operation O nome da operação de acesso ao objeto.
ownerId O identificador do proprietário do objeto.
securityDescriptor (somente SMB) Mostra a lista de controle de acesso discricionário (DACL) definida em um objeto, no formato SDDL.
shareName O nome do compartilhamento que está sendo acessado.
source O ID do compartilhamento de arquivos que está sendo auditado.
sourceAddress O endereço IP da máquina cliente de compartilhamento de arquivos.
status O status da operação. Somente o êxito é registrado em log (as falhas são registradas em log, com a exceção das falhas decorrentes de permissões negadas).
timestamp A hora em que a operação ocorreu com base no timestamp do sistema operacional do gateway.
version A versão do formato do log de auditoria.

Atributos registrados em log por operação

A tabela a seguir descreve os atributos de log de auditoria do Gateway de Arquivos do S3 registrados em cada operação de acesso a arquivos.

Ler dados

Gravar dados

Criar pasta

Criar arquivo

Renomear arquivo/pasta

Excluir arquivo/pasta

Atributos de gravação (alterar ACL: Somente SMB)

Atributos de gravação (chown)

Atributos de gravação (chmod)

Atributos de gravação (chgrp)
accessMode X X X
accountDomain (somente SMB) X X X X X X X X X X
accountName (somente SMB) X X X X X X X X X X
bucket X X X X X X X X X X
clientGid (somente NFS) X X X X X X X X X
clientUid (somente NFS) X X X X X X X X X
ctime X X
groupId X X
fileSizeInBytes X
gateway X X X X X X X X X X
mtime X X
newObjectName X
objectName X X X X X X X X X X
objectType X X X X X X X X X X
operation X X X X X X X X X X
ownerId X X X
securityDescriptor (somente SMB) X X
shareName X X X X X X X X X X
source X X X X X X X X X X
sourceAddress X X X X X X X X X X
status X X X X X X X X X X
timestamp X X X X X X X X X X
version X X X X X X X X X X