Gerando relatórios de uso detalhados

Em IBM Cloud Logs, você pode exportar um Data Usage Report como CSV, TSV ou JSON. O relatório fornece uma visão geral do uso de dados de sua instância no mês atual, nos 30 dias anteriores ou nos 90 dias anteriores.

É possível gerar um relatório para:

O mês atual
Últimos 30 dias
Últimos 90 dias

Pré-requisitos

Deve-se configurar um depósito de métricas.
Deve-se ativar o recurso de uso de dados Para obter mais informações, consulte Ativando métricas de uso de dados.

Informações incluídas em um relatório.

O relatório de uso detalhado inclui as seguintes informações por aplicativo, subsistema, gravidade, prioridade, política de TCO e tipo:

Data
Total de dados enviados (GB)

Gerando um relatório

Conclua as etapas a seguir para exportar o Data Usage Report como um arquivo CSV:

Navegue até sua instância IBM Cloud Logs: Observability > Logging > Cloud Logs > Sua instância de serviço > Open Dashboard.
Selecione o ícone Uso Ícone > Uso de dados.

A página Uso de dados é aberta.
Selecione Relatório detalhado para o tipo de relatório de uso de dados.
Selecione o intervalo de datas.
Escolha o formato de exportação.

Os valores válidos são: CSV, TSV, e JSON.

Use CSV e TSV para gerenciar dados por meio de planilhas.

Use o site JSON para gerenciar dados por meio de integrações automatizadas.
Para os formatos de exportação CSV e TSV, selecione se você deseja incluir cabeçalhos no relatório. Quando selecionado, os nomes das colunas serão adicionados como a primeira linha do arquivo exportado.
Clique em Exportar.

Exportação de um relatório detalhado de uso de dados usando a API

Você pode exportar um relatório detalhado de uso de dados programaticamente, chamando a API IBM Cloud Logs.

O exemplo a seguir mostra uma consulta que você pode usar para exportar o relatório detalhado de uso de dados. Ao chamar a API, substitua as variáveis de ID e o token do IAM pelos valores específicos para sua instância do IBM Cloud Logs.

Os relatórios detalhados de uso de dados são exportados usando o parâmetro de consulta query com o valor detailed.

Você pode recuperar o relatório detalhado de uso de dados para um intervalo de tempo especificado para sua instância IBM Cloud Logs com os parâmetros de solicitação range. Os valores válidos para o parâmetro range são current_month, last_30_days, last_90_days e last_week. O padrão é current_month.

curl 'https://{instance_ID}.api.{region}.logs.cloud.ibm.com/v1/data_usage?query=detailed&&range=last_30_days' \
    -H 'Authorization: Bearer {iam_token}' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json'

Uma resposta bem-sucedida retorna o relatório detalhado de uso de dados para o intervalo de tempo especificado. Para obter mais informações sobre a API, consulte Obter status de exportação de métricas de uso de dados ou retornar relatório de uso de dados.

Exportação do relatório detalhado de uso de dados usando a CLI

Antes de começar, siga as etapas para definir o endpoint da API da instância IBM Cloud Logs.

Para exportar o relatório detalhado de uso de dados usando o plug-in IBM Cloud Logs CLI, execute o comando ibmcloud logs data-usage comando. Por exemplo, o comando a seguir exporta o relatório detalhado de uso de dados dos últimos 30 dias.

ibmcloud logs data-usage --query detailed --range last_30_days

Os relatórios detalhados de uso de dados são exportados usando o parâmetro query com o valor detailed.

Você pode recuperar o relatório detalhado de uso de dados em um intervalo de tempo especificado para sua instância IBM Cloud Logs com os parâmetros de solicitação range. Os valores válidos do parâmetro range são current_month, last_30_days, last_90_days e last_week. O padrão é current_month.

Um comando bem-sucedido retorna o relatório detalhado de uso de dados para o intervalo de tempo especificado.