Criar relatório

Depois de cumprir os pré-requisitos, você estará pronto para configurar o relatório da Conta da AWS e enviar os dados de uso para o Application Cost Profiler da AWS. Esta seção descreve como configurar o relatório e enviar dados de uso ao Application Cost Profiler.

Configurar seu relatório do Application Cost Profiler

O procedimento a seguir mostra como configurar o relatório que você deseja gerar com base na data de uso. Você configura detalhes como a frequência com que o relatório é gerado.

nota

Se sua Conta da AWS faz parte de uma organização AWS, configure o relatório usando a conta de gerenciamento ou uma conta de membro individual. Os relatórios configurados para contas individuais contêm apenas dados dessa conta. Os relatórios configurados usando a conta de gerenciamento podem incluir dados de toda a organização.

O bucket do Amazon S3 usado para a saída do relatório deve pertencer à conta que cria a configuração do relatório.

Configurar o relatório do Application Cost Profiler

1. Abra um navegador da Web e faça login no console do Application Cost Profiler.

2. Escolha Começar agora para configurar ou modificar um relatório.

3. Insira um Nome do relatório e uma Descrição do relatório para o relatório.

4. Insira o nome do bucket do S3 no campo Inserir nome do bucket S3 e insira o prefixo do S3 no campo Inserir prefixo do S3. Para obter mais informações sobre como criar buckets do S3 e conceder permissões ao Application Cost Profiler, consulte Configuração de buckets do Amazon S3 para o Application Cost Profiler.

5. Selecione as opções que você deseja que o relatório tenha:

   • Frequência de tempo: escolha se o relatório é gerado em uma cadência diária, mensal ou nas duas.

   • Formato de saída do relatório: escolha o tipo de arquivo a ser criado em no bucket do Amazon S3. Se você escolher CSV, o Application Cost Profiler criará um arquivo de texto de valores separados por vírgula com compactação gzip para os relatórios. Se escolher Parquet, um arquivo Parquet será gerado para os relatórios.

6. Escolha Configurar para salvar as configurações do relatório.

nota

Você também pode usar a API da AWS Application Cost Profiler para configurar relatórios.

Verifique as configurações do relatório escolhendo Começar agora para ver a configuração atual do relatório.

nota

Você só pode ter um relatório configurado. Retornar à página de configuração editará o relatório existente.

Depois de configurar o relatório, a ingestão de dados é ativada. Integre os serviços com o Application Cost Profiler para fornecer dados de uso dos recursos.

Relatar dados de uso de inquilinos dos serviços

Depois de configurar o relatório, você estará pronto para enviar dados de uso do inquilino dos recursos ou serviços da conta. Você deve informar o Application Cost Profiler quando o recurso estiver sendo usado por um inquilino específico. Por exemplo, se o serviço aceita chamadas de API de diferentes inquilinos, registre um horário de início e término para cada inquilino ao iniciar e encerrar uma chamada de API desse inquilino. O Application Cost Profiler usa esses dados para gerar relatórios sobre o custo do serviço, de acordo com a quantidade de tempo gasto no trabalho de cada inquilino.

Para fornecer ao Application Cost Profiler os dados de uso, faça o seguinte:

• Preparar dados de uso de recursos: crie tabelas que descrevam quando um recurso é usado por um inquilino específico.

• Carregar dados de uso: faça upload das tabelas em um bucket do Amazon S3 que você concedeu permissão ao Application Cost Profiler para acessar.

• Importar dados de uso: chame a operação da API ImportApplicationUsage para que o Application Cost Profiler saiba que os dados estão prontos para serem processados.

As seções a seguir descrevem essas etapas em detalhes.

Etapa 1: preparando os dados de uso de recursos

À medida que um recurso está sendo usado no serviço, você rastreia qual inquilino o está usando. Registre esses dados em uma tabela que você pode carregar posteriormente para ser importada pelo Application Cost Profiler. Cada linha na tabela descreve um recurso, o inquilino que está usando o recurso e os horários de início e término desse uso. Um exemplo de recurso é uma instância do Amazon Elastic Compute Cloud (Amazon EC2) que está sendo usada.

Essa etapa exige que você integre o código ao serviço para gerar as informações corretas sobre o uso.

Os possíveis valores de alocação de custos estão indicados na tabela a seguir.

Campo	Descrição
ApplicationId	Identifica o aplicativo ou produto no sistema que está sendo usado. Define o escopo dos metadados do inquilino.
TenantId	Um identificador no sistema para o inquilino que está consumindo o recurso especificado. O Application Cost Profiler agrega esse nível no ApplicationId.
TenantDesc	(Opcional) Dados adicionais sobre o inquilino para seus relatórios adicionais.
UsageAccountId	A conta na qual o recurso é executado (importante para contas que fazem parte de uma organização).
startTime	Registro de data e hora (em milissegundos e microssegundos) da Epoch, em UTC. Indica a hora de início do período de uso pelo inquilino especificado.
EndTime	Registro de data e hora (em milissegundos e microssegundos) da Epoch, em UTC. Indica a hora final do período de uso pelo inquilino especificado.
ResourceId	O nome do recurso da Amazon (ARN) do recurso usado.
Nome	(Opcional) Como alternativa à especificação de um resourceID, você pode especificar um Nome de tag de recurso para atribuir custos a um conjunto de recursos (o campo deve incluir o valor que você deseja usar para o Nome da tag. As tags de recursos são habilitadas como parte do relatório de custo e uso. Para obter mais informações sobre as tags de recursos, consulte os Detalhes das tags de recursos no Guia do usuário do relatório de custo e uso.

A saída deve estar em um arquivo de valores separados por vírgula (.csv) que inclua uma linha de título, conforme mostrado no exemplo a seguir.

ApplicationId,TenantId,TenantDesc,UsageAccountId,StartTime,EndTime,ResourceId
MyApp,Tenant1,,123456789012,1613681437032.9001,1613681437041.5312,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681245531.4426,1613681245551.1323,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant1,,123456789012,1613681904815.3381,1613681904930.0972,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234
MyApp,Tenant2,,123456789012,1613681904765.1956,1613681904946.574,arn:aws:ec2:us-east-1:123456789012:instance/1234-abcd-example-1234

Salve os dados como um arquivo com uma extensão.csv (ou .csv.gzip se ele for compactado com gzip). Quando você carrega esses dados para o Application Cost Profiler, cada fatia de tempo é atribuída ao inquilino associado. Neste exemplo, o relatório inclui o intervalo temporal do custo da instância do Amazon EC2 para esse inquilino. Somente para instâncias do Amazon EC2, fatias que não estão associadas a um locatário específico são adicionadas a um inquilino não atribuído. Os intervalos de tempo sobrepostos são contados várias vezes. É sua responsabilidade garantir que os dados na tabela de uso sejam precisos.

nota

O arquivo deve representar uma hora de tempo. Se um recurso for usado por várias horas, encerre o uso na hora e tenha um novo registro no próximo arquivo que comece ao mesmo tempo.

Você deve enviar um único arquivo contendo os dados de uma hora inteira. Se vários arquivos forem enviados para os dados da mesma hora, o Application Cost Profiler considerará somente os dados no arquivo mais recente.

Por exemplo, a tabela a seguir mostra como o Application Cost Profiler calcula o uso de três inquilinos, em uma hora (3.600.000 milissegundos), com base nos intervalos de tempo fornecidos.

Inquilino	Fatias de tempo fornecidas	Porcentagem calculada do custo por hora
Inquilino 1	1.200.000 ms	33,34%
Inquilino 2	600.000 m	16.66%
<unattributed>		50,00%

Neste exemplo, o Inquilino 1 recebe um terço da hora e o Inquilino 2 recebe um sexto da hora. A meia hora restante (1.800.000 ms) não é atribuída a nenhum dos clientes, o que representa 50% da hora.

Atualmente, os seguintes recursos estão habilitados para o Application Cost Profiler:

• Instâncias do Amazon EC2 (apenas sob demanda e instâncias spot)

• Funções do Lambda (se você estiver enviando dados para uma função do Lambda, deverá enviar o ARN do recurso não qualificado como ResourceId).

• Instâncias do Amazon Elastic Container Service (Amazon ECS)

• Filas do Amazon Simple Queue Service (Amazon SQS)

• Amazon Simple Notification Service (Amazon SNS) topics

• O Amazon DynamoDB lê e grava

nota

O uso do Amazon SQS, Amazon SNS e DynamoDB não é cobrado por tempo, diferentemente da maioria dos recursos. No caso deles, o uso durante uma hora (por exemplo, várias leituras e gravações no DynamoDB) é categorizado pela porcentagem da hora que você aloca para diferentes inquilinos, independentemente de quando as leituras ou gravações aconteceram durante a hora.

Etapa 2: fazer o upload do uso do recurso

Depois de ter um arquivo de uso pelo inquilino, faça o upload do arquivo de dados para o Amazon S3 e certifique-se de que o Application Cost Profiler tenha permissão para acessá-lo.

Para saber mais sobre como criar funções para o bucket do S3, consulte Pré-requisitos específicos do Application Cost Profiler.

Você deve garantir que o Application Cost Profiler tenha acesso ao bucket do S3. Isso só precisa ser feito uma vez por bucket do S3 (você pode reutilizar o mesmo bucket para fazer upload de vários arquivos de uso). Para obter mais informações sobre o acesso ao bucket, consulte Fornecendo ao Application Cost Profiler acesso ao bucket S3 de entrega de relatórios. Se o bucket estiver criptografado, consulte Fornecendo ao Application Cost Profiler acesso a buckets S3 criptografados com SSE-KMS.

nota

Não é necessário criptografar os buckets do S3 que você usa para dados de uso.

Faça upload dos dados para o bucket do S3 como um arquivo, com uma extensão.csv (ou .csv.gzip se compactado com gzip) e em intervalos de hora em hora. Depois de carregar um novo arquivo, informe ao Application Cost Profiler que o upload foi realizado para que o arquivo possa ser importado para o relatório.

nota

Ao conceder ao Application Cost Profiler acesso aos dados de uso, você concorda que podemos copiar temporariamente esses objetos de dados de uso para a Região da AWS Leste dos EUA (Norte da Virgínia) enquanto processamos relatórios. Esses objetos de dados serão mantidos na região Leste dos EUA (Norte da Virgínia) até que a geração do relatório mensal seja concluída.

Etapa 3: importar dados de uso para o Application Cost Profiler

Depois de fazer o upload dos dados de uso em um bucket do Amazon S3 ao qual o Application Cost Profiler tem acesso, informe ao Application Cost Profiler que os dados existem e importe-os para o relatório final. Você faz isso usando a operação ImportApplicationUsage no API Application Cost Profiler.

Para obter informações sobre a API da AWS Application Cost Profiler, incluindo a operação ImportApplicationUsage, consulte a API da AWS do Application Cost Profiler.

O exemplo a seguir mostra como chamar ImportApplicationUsage. Substitua o texto de entrada entre colchetes pelos valores do bucket do S3 e do objeto carregado.

POST /ImportApplicationUsage HTTP/1.1
Content-type: application/json

{
    "sourceS3Location" : {
        "bucket": "<bucket-name>",
        "key": "<object-key>",
        "region": "<region-id>"
    }
}

nota

O parâmetro region só é necessário se o bucket estiver em uma Região da AWS que esteja desativado por padrão. Para obter mais informações, consulte Gerenciar as Regiões da AWS no Referência geral da AWS.

O Application Cost Profiler gera um novo relatório na frequência solicitada ao configurar seu relatório, usando os dados importados com ImportApplicationUsage.

Depois de configurar o relatório e automatizar a importação dos dados de uso para o Application Cost Profiler, você estará pronto para visualizar os relatórios gerados. Para obter mais informações sobre os relatórios, consulte Como usar os relatórios do Application Cost Profiler.