Relatórios de Custos

Os relatórios de custo são arquivos CSV (valores separados por vírgulas) e refletem o custo do consumo de recursos. Eles são gerados diariamente e armazenados em um bucket do serviço Object Storage. Use a página Relatórios de Custo e Uso para fazer download e acessar os relatórios.

Importante

Os relatórios de uso foram descontinuados em 31 de janeiro de 2025. Em vez disso, você pode usar relatórios de custos no formato proprietário da OCI e no formato FOCUS para analisar seu consumo. Para obter mais informações, consulte Tipos de Relatório de Custos. Você pode continuar acessando seus arquivos CSV de relatórios de uso existentes até 31 de julho de 2025.

Um relatório de custos é um arquivo CSV semelhante a um relatório de uso, mas também inclui colunas de custo. O relatório pode ser usado para obter um detalhamento dos itens de linha da fatura com granularidade no nível de recurso. Como resultado, você pode otimizar seus gastos com o Oracle Cloud Infrastructure e tomar decisões de gastos com a nuvem mais informadas.

Os relatórios de custo CSV FOCUS padrão do setor, que estão em conformidade com a FinOps Open Cost & Usage Specification (FOCUS), também são gerados e estão disponíveis na página Relatórios de Custo e Uso. Para obter mais informações, consulte Esquema de Relatório de Custo FOCUS. Os relatórios CSV FOCUS estão disponíveis em todas as regiões dos realms comerciais.

Observação

Os relatórios de custo não se aplicam a tenancies sem medição de consumo.

Política do Serviço IAM Obrigatória

Para usar o Oracle Cloud Infrastructure, um administrador deve ser membro de um grupo com acesso de segurança concedido em uma política por um administrador da tenancy. Esse acesso será necessário se você estiver usando a Console ou a API REST com um SDK, uma CLI ou outra ferramenta. Se você receber uma mensagem de que não tem permissão ou que não está autorizado, verifique com o administrador da tenancy qual tipo de acesso você tem e em qual compartimento seu acesso funciona.

Se você for iniciante em matéria de políticas, consulte Conceitos Básicos de Políticas e Políticas Comuns.

Para usar relatórios de custo, é necessária a seguinte instrução de política:

define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq
endorse group <group> to read objects in tenancy usage-report
Observação

Este exemplo tem um OCID de tenancy específico, porque os relatórios são armazenados em um bucket do serviço Object Storage de propriedade da Oracle hospedado pelo Oracle Cloud Infrastructure e não na tenancy de um cliente.

Autenticação e Autorização

Cada serviço do Oracle Cloud Infrastructure se integra ao IAM para autenticação e autorização, para todas as interfaces (Console, SDK ou CLI e API REST).

Um administrador de uma organização precisa configurar grupos, compartimentos e políticas que controlam quais usuários podem acessar quais serviços, quais recursos e o tipo de acesso. Por exemplo, as políticas controlam quem pode criar novos usuários, criar e gerenciar a rede na nuvem, criar instâncias, criar buckets, fazer download de objetos e assim por diante. Para obter mais informações, consulte Gerenciando Domínios de Identidades. Para ver detalhes específicos sobre a gravação de políticas para cada um dos diferentes serviços, consulte a Referência de Políticas.

Se você for um usuário comum (não um administrador) que precisa usar os recursos do Oracle Cloud Infrastructure que a empresa possui, entre em contato com um administrador para configurar um ID de usuário para você. O administrador pode confirmar o(s) compartimento(s) que você pode usar.

Tipos de Relatório de Custo

Os relatórios de custo proprietários da OCI e os relatórios de custo FOCUS estão disponíveis na página Relatórios de Custo e Uso para download. Os relatórios de custos são gerados automaticamente a cada seis horas e armazenados em um bucket do serviço Object Storage de propriedade da Oracle. Os relatórios contêm uma linha por cada recurso do Oracle Cloud Infrastructure (como instância, bucket do serviço Object Storage, VNIC) por hora, juntamente com informações de consumo (uso, preço, custo), metadados e tags. Os relatórios de custos geralmente contêm seis horas de dados de uso e, ocasionalmente, dados recebidos tardiamente, mas eles podem ser adiados por até 24 horas. Os relatórios de custos são retidos por um ano.

FOCUS (FinOps Open Cost & Usage Specification) é uma especificação e um esquema de código-fonte aberto para dados de faturamento na nuvem. Os relatórios FOCUS na Console do OCI são particionados por data de uso e são exibidos em uma estrutura de pastas recolhível e expansível por ano, mês e dia para ajudar na visualização. Por exemplo, os relatórios de uso que ocorrem em 24 de maio de 2024 são encontrados em Relatórios FOCUS > 2024 > 05 > 24. Para obter mais informações, consulte Listando Relatórios de Custo.

Os relatórios de custos podem conter correções. As correções são adicionadas como novas linhas ao relatório, com o conjunto de colunas lineItem/iscorrection e o valor referenceNo da linha corrigida preenchida na coluna lineItem/backReference.

O nome do arquivo de cada relatório de custos é anexado com um valor numérico de incremento automático e o primeiro arquivo recebe o anexo -00001.csv.gz. Os arquivos do relatório de custos são divididos em vários arquivos quando mais de 1 milhão de registros estão presentes no arquivo do relatório de custos. Quando uma divisão de arquivo ocorre, novos arquivos sucessivos são gerados e recebem os anexos -00002.csv.gz, -00003.csv.gz e assim por diante, para cada divisão de arquivo. Se o tamanho do arquivo do relatório de custos permanecer abaixo do limite de tamanho do arquivo, a divisão do arquivo não ocorrerá e apenas um arquivo será gerado.

A nomeação do arquivo para relatórios FOCUS corresponde ao ano, mês e dia em que o uso ocorreu.

Esquema do Relatório de Custos do Proprietário do OCI

A tabela a seguir mostra o esquema do relatório de custos proprietário do OCI.

Nome do Campo Descrição
lineItem/referenceNo Identificador da linha. Usado para depuração e correções.
lineItem/TenantId O identificador (OCID) do tenant do Oracle Cloud Infrastructure.
lineItem/intervalUsageStart O horário inicial do intervalo de uso do recurso no UTC.
lineItem/intervalUsageEnd O horário final do intervalo de uso do recurso no UTC.
product/service O serviço em que o recurso se encontra.
product/compartmentId O ID do compartimento que contém o recurso.
product/compartmentName O nome do compartimento que contém o recurso.
product/region A região que contém o recurso.
product/availabilityDomain O domínio de Disponibilidade que contém o recurso.
product/resourceId O identificador do recurso.
usage/billedQuantity

A quantidade do recurso que foi faturada durante o intervalo de uso.

Observação: billedQuantity, myCost e unitPrice incluem números Excedentes e nós quebrados em pools de GPU dedicados. Nós quebrados não são cobrados de você, mesmo que estejam incluídos no billedQuantity.

usage/billedQuantityOverage A quantidade de uso faturada como excedente em relação ao commit do Oracle Universal Credits ou a quantidade de uso faturada em relação ao compromisso de Alocação Financiada.

Observação: essa quantidade não inclui nós quebrados em pools de GPU dedicados, que não são faturados para você.

cost/subscriptionId Um identificador exclusivo associado ao seu compromisso ou inscrição.
cost/productSku O Número do Item do recurso na linha.
product/description A descrição do produto para o recurso na linha.
cost/unitPrice

O custo faturado para cada unidade do recurso usada.

Observação: billedQuantity, myCost e unitPrice incluem números Excedentes.

cost/unitPriceOverage O custo por unidade de uso para uso excedente de um recurso.
cost/myCost

O custo cobrado para esta linha de uso. myCost é igual a usage/billedQuanty * cost/unitPrice.

Observação: billedQuantity, myCost e unitPrice incluem números Excedentes.

cost/myCostOverage O custo faturado por uso excedente de um recurso.
cost/currencyCode O código da moeda para sua tenancy.
cost/billingUnitReadable A medida da unidade associada a usage/billedQuantity na linha. Este campo é estruturado como: <count> <GiB/MiB/TiB/PiB> <HOURS/MILLIS/MONTH/SECOND> <measure>. Por exemplo: ONE GiB MONTH DATA_TRANSFERRED.
cost/skuUnitDescription O uso de uma SKU específica.
cost/overageFlag O custo quando você exceder seus Créditos Universais da Oracle
lineItem/isCorrection Usado se a linha atual for uma correção. Consulte a coluna lineitem/backReference para obter uma referência ao item de linha corrigido.
lineItem/backReferenceNo Referência de correções e retificações de dados. Se for necessária uma correção em um item de linha existente, uma nova linha será adicionada com os valores corrigidos e uma referência à linha original. Usado com o campo lineItem/isCorrection.
cost/attributedCost cost/attributedCost e usage/attributedUsage são iguais a cost/myCost e usage/billedQuantity para qualquer recurso de tipo de cluster de máquina não virtual. Caso contrário, esse campo mostrará o custo de bancos de dados plugáveis em um cluster de máquina virtual. Para obter mais informações, consulte Exibindo Custo e Uso de Bancos de Dados Plugáveis de Cluster de Máquina Virtual.
usage/attributedUsage cost/attributedCost e usage/attributedUsage são iguais a cost/myCost e usage/billedQuantity para qualquer recurso de tipo de cluster de máquina não virtual. Caso contrário, esse campo mostrará o uso de bancos de dados plugáveis em um cluster de máquina virtual. Para obter mais informações, consulte Exibindo Custo e Uso de Bancos de Dados Plugáveis de Cluster de Máquina Virtual.
tags/ O relatório contém uma coluna por definição de tag (inclui todas as definições de tag, e não apenas tags de rastreamento de custos).

Esquema do Relatório de Custos FOCUS

A tabela a seguir mostra o esquema do relatório de custos FOCUS, incluindo o mapeamento para o esquema do relatório de custos proprietário do OCI.

ID da coluna Nome para Exibição Mapeamento Proprietário Tipo Descrição
AvailabilityZone Zona de Disponibilidade product/availabilityDomain String Domínio de Disponibilidade Lógica.
BilledCost Custo Faturado cost/myCost BigDecimal O custo calculado após todos os descontos terem sido aplicados.

Observação: o Custo Faturado não inclui impostos e pode variar do valor da NFF.

BillingAccountId ID da Conta de Faturamento cost/subscriptionId String Identificador da inscrição.
BillingAccountName Nome da Conta de Faturamento NONE String Nulo
BillingCurrency Moeda de Faturamento cost/currencyCode CurrencyCode Código de moeda para o custo.
BillingPeriodEnd Fim do Período de Cobrança NONE DateTime A data e a hora finais do período de faturamento.

Observação: o início e o fim do período de faturamento são baseados no limite de uso mensal atual e podem ser diferentes da data em que as NFFs de compromisso são emitidas.

BillingPeriodStart Início do Período de Faturamento NONE DateTime A data e o horário inicial do período de faturamento.
ChargeCategory Categoria do Encargo lineItem/isCorrection String

Indica uma taxa inicial ou recorrente, custo de uso que já ocorreu, um ajuste após o fato (créditos) ou impostos.

Custo de uso que já ocorreu (Usage) ou um ajuste após o fato (Adjustment).
ChargeDescription Descrição da Cobrança product/description String A descrição da SKU da compra e do preço do encargo.
ChargeFrequency Frequência de Cobrança NONE String Indica a frequência com que uma cobrança ocorre e é comumente usada para entender o período de recorrência. O padrão é Usage-based.
ChargePeriodEnd Fim do período de cobrança lineItem/intervalUsageEnd String Hora de início do uso em milissegundos desde a época.
ChargePeriodStart Início do período de cobrança lineItem/intervalUsageStart String Hora final do uso em milissegundos desde a época.
ChargeSubcategory Subcategoria de Encargo NONE String Nulo
CommitmentDiscountCategory Categoria de Desconto do Compromisso NONE String Nulo
CommitmentDiscountId ID do Desconto do Compromisso NONE String Nulo
CommitmentDiscountName Nome do Desconto do Compromisso NONE String Nulo
CommitmentDiscountType Tipo de Desconto do Compromisso NONE String Este campo é nulo porque o OCI não tem o conceito de instâncias reservadas.
EffectiveCost Custo Efetivo cost/myCost BigDecimal O custo calculado, incluindo todos os descontos aplicáveis.
InvoiceIssuerName Emissor da NFF NONE String O padrão é Oracle como o único valor indicado.
ListCost Custo de Lista NONE BigDecimal Custo calculado com base no preço de lista atual.
ListUnitPrice Preço Unitário da Lista NONE BigDecimal Com base no preço de lista global atual, o preço unitário de uma única unidade de preço da SKU associada, excluindo qualquer desconto.
PricingCategory Categoria de Preço NONE String Nulo
PricingQuantity Quantidade de Preço usage/billedQuantity BigDecimal Valor faturável arredondado por hora, se aplicável.
PricingUnit Unidade de Preços cost/skuUnitDescription String Descrição das unidades da SKU.
ProviderName Provedor NONE String O padrão é Oracle.
PublisherName Editor NONE String Oracle, exceto para listagens de marketplace de terceiros.
Região Região product/region String A região associada à entrada de custo, indexada junto com tenantId, compartmentId, resourceId e resourceMeter para exclusividade.
ResourceId ID do Recurso product/resourceId String Identificador de recurso exclusivo, indexado junto com tenantId, compartmentId, região e resourceMeter para exclusividade.
ResourceName Nome do Recurso NONE String Este campo é nulo porque a Oracle não publica esse valor em seus relatórios de custo.
ResourceType Tipo de Recurso NONE String O tipo de recurso ao qual a cobrança se aplica. Por exemplo, Storage.
ServiceCategory Categoria de Serviço NONE String Valores de enumeração para uma classificação de serviço aceita em FOCUS.
ServiceName Nome do Serviço product/service String O serviço associado ao recurso, indexado junto com tenantId, compartmentId, resourceId e resourceMeter para exclusividade.
SkuId ID DA SKU cost/productSku String O ID exclusivo da SKU.
SkuPriceId ID do Preço SKU NONE String Este campo é nulo porque esta construção não existe no OCI.
SubAccountId ID da subconta lineItem/TenantId String O identificador (OCID) do tenant do Oracle Cloud Infrastructure.
SubAccountName Nome da Subconta NONE String O nome da tenancy.
Etiquetas Etiquetas tags/ JSON Tags associadas à entrada, armazenadas como uma matriz de bytes.
UsageQuantity Quantidade de Uso usage/billedQuantity BigDecimal Valor faturável arredondado por hora, se aplicável.
UsageUnit Unidade de Uso cost/skuUnitDescription String Descrição das unidades da SKU.