Exportação de dados de uso no formato FOCUS
Exporte seus dados de uso do IBM Cloud® no formato FOCUS (Open Cost & Usage Specification) do FinOps para simplificar o gerenciamento de custos em várias nuvens e permitir a integração perfeita com as ferramentas do FinOps.
O formato FOCUS é um padrão entre nuvens desenvolvido pela FinOps Foundation que normaliza os dados de faturamento e uso entre os provedores de nuvem. A IBM Cloud agora oferece suporte ao formato FOCUS v1.2 ( FinOps Open Cost and Usage Specification) para relatórios de custo e uso. Ao exportar seus dados de uso do IBM Cloud no formato FOCUS, você pode analisar os custos do IBM Cloud juntamente com os dados do AWS, Azure e GCP sem transformação personalizada. Para obter mais informações, consulte a especificação FinOps Foundation FOCUS v1.2.
Antes de Iniciar
Antes de exportar dados de uso no formato FOCUS, verifique se você tem os seguintes acessos e recursos:
- Acesso do administrador de faturamento ou do proprietário da conta à conta IBM Cloud
- Acesso ao console ou à CLI do IBM Cloud
- Compreensão de seus requisitos de gerenciamento de custos e da ferramenta FinOps
Compreensão dos benefícios do formato FOCUS
O formato FOCUS oferece várias vantagens para o gerenciamento de seus custos de nuvem:
- Visibilidade aprimorada de várias nuvens
- Normalize os dados de uso de IBM Cloud com AWS Cost and Usage Reports (CUR), Azure CSV exports e GCP billing data para análise unificada de custos.
- Integração direta de ferramentas
- Importe dados formatados no FOCUS diretamente para as plataformas FinOps, como Apptio Cloudability, CloudHealth, Kubecost e outras ferramentas de otimização de custos sem scripts de transformação personalizados.
- Redução do tempo de integração
- Elimine os processos manuais de transformação de dados, reduzindo o tempo e o custo necessários para integrar os dados de faturamento do IBM Cloud aos seus fluxos de trabalho de gerenciamento de custos.
- Transparência aprimorada
- Acesse dimensões de faturamento padronizadas que se alinham com as práticas recomendadas do setor, facilitando o entendimento e a validação de suas cobranças em IBM Cloud.
- Paridade competitiva
- Beneficie-se do mesmo formato padronizado usado por outros provedores líderes de serviços em nuvem, garantindo práticas consistentes de gerenciamento de custos em seu ambiente multinuvem.
Exportação de dados de uso
Os dados de uso em nível de instância fornecem detalhes granulares sobre instâncias de recursos individuais, permitindo a alocação detalhada de custos e o estorno.
- Efetue login no console da IBM Cloud.
- Acesse Gerenciar > Faturamento e uso > Uso.
- Clique no botão FOCUS. O sistema faz o download de um arquivo CSV que contém dados de uso em nível de instância no formato FOCUS v1.2, com colunas adicionais para detalhes específicos do recurso.
Campos totalmente compatíveis
IBM CSV o arquivo inclui todos os campos obrigatórios do FOCUS v1.2:
| Campo | Tipo | Descrição |
|---|---|---|
BilledCost |
Decimal | Custo faturado ao cliente |
BillingCurrency |
Sequência | Código da moeda (ISO 4217) |
ChargeCategory |
Sequência | Tipo de cobrança (uso, compra, imposto, ajuste) |
ChargeDescription |
Sequência | Descrição da cobrança |
ChargePeriodEnd |
DateTime | Fim do período de cobrança (ISO 8601) |
ChargePeriodStart |
DateTime | Início do período de cobrança (ISO 8601) |
EffectiveCost |
Decimal | Custo amortizado após descontos |
ListUnitPrice |
Decimal | Preço de tabela por unidade antes dos descontos |
PricingCategory |
Sequência | Modelo de precificação |
PricingQuantity |
Decimal | Quantidade usada para determinação do preço |
PricingUnit |
Sequência | Unidade de medida para precificação |
ProviderName |
Sequência | Sempre " IBM " |
PublisherName |
Sequência | Nome do editor de serviços |
ResourceId |
Sequência | Identificador exclusivo de recursos |
ResourceName |
Sequência | Nome do recurso |
ServiceCategory |
Sequência | Categoria de serviço de alto nível |
ServiceName |
Sequência | Nome do serviço |
SkuId |
Sequência | Identificador SKU |
Campos adicionais suportados
Além dos 16 campos obrigatórios, os relatórios do IBM Cloud FOCUS incluem 39 campos adicionais:
| Categoria | Nome do campo |
|---|---|
| Conta e faturamento: | BillingAccountId, BillingAccountName, BillingAccountType, BillingPeriodEnd, BillingPeriodStart, InvoiceIssuerName |
| Geográfico: | AvailabilityZone, RegionId, RegionName |
| Compromisso e desconto: | CommitmentDiscountCategory, CommitmentDiscountId, CommitmentDiscountName, CommitmentDiscountType, CommitmentDiscountUnit |
| Detalhamento de custos: | ContractedCost, ContractedUnitPrice, ListCost |
| Detalhes da cobrança: | ChargeClass, ChargeFrequency |
| Consumo: | ConsumedQuantity, ConsumedUnit |
| Precificação: | PricingCurrency, SkuMeter |
| Metadados de recursos: | ResourceType, ServiceSubcategory, Tags |
| IBM-Extensões específicas: | x_DiscountId, x_DiscountName, x_DiscountQuantity, x_OfferId, x_OfferCredit |
Exportação de dados de uso usando a API
Você pode automatizar as exportações de dados de uso usando a API IBM Cloud Usage Reports. Para obter mais informações, consulte API de relatórios de uso.
-
Obtenha uma chave de API com acesso de faturamento apropriado. Para obter mais informações, consulte Gerenciando chaves de API.
-
Use o seguinte ponto de extremidade da API para exportar dados de uso:
curl -X GET "https://billing.cloud.ibm.com/v4/accounts/{account_id}/focus/{month}" \ -H "Authorization: Bearer {iam_token}" \ -H "Accept: text/csv"
Substitua {account_id} pelo seu ID de conta IBM Cloud (obrigatório), {month} pelo mês do relatório no formato AAAA-MM (por exemplo, 2024-01) e {iam_token} pelo seu token de acesso ao IAM.
Parâmetros da API
A API de exportação do FOCUS oferece suporte aos seguintes parâmetros:
account_id(obrigatório) : A ID da conta IBM Cloud.
month(obrigatório)- Informe o mês no formato AAAA-MM (por exemplo, 2024-01).
Cabeçalhos:
Authorization(obrigatório) : Token de portador para autenticação do IAM.
x-focus-version(opcional)- Versão do FOCUS a ser usada (padrão: 1.2 ). Defina como
truepara ignorar o cache e gerar um novo relatório.
Query Parameters:
format- As opções incluem:
- json (padrão)- retornará resultados no formato JSON paginado.
- csv- retornará todos os resultados no formato CSV.
_limit(opcional)- Limite de paginação, máximo de 250 (padrão: 200).
Validação de exportações no formato FOCUS:
Para garantir que os dados exportados atendam às especificações do FOCUS v1.2, você pode validar os arquivos usando a ferramenta de validação do FOCUS da FinOps Foundation. As exportações do IBM Cloud FOCUS foram projetadas para passar na validação com 100% de conformidade em todos os 16 campos obrigatórios MUST.
Comparação entre os formatos IBM nativo e FOCUS v1.2
Os formatos IBM nativo e FOCUS v1.2 estão disponíveis para exportações de uso. A tabela a seguir destaca as principais diferenças:
| Aspecto | IBM Formato nativo | FOCUS v1.2 Formato |
|---|---|---|
| Nomes da coluna | IBM-convenções de nomenclatura específicas | Nomes de colunas padronizados do FOCUS v1.2 |
| Compatibilidade com várias nuvens | IBM Cloud somente | Compatível com AWS, Azure, GCP |
| FinOps suporte a ferramentas | Requer transformação personalizada | Suporte à importação direta |
| Granularidade de dados | Mesmo nível de detalhe | Mesmo nível de detalhe |
| Conformidade | IBM-específico | 100% em conformidade com o FOCUS v1.2 (16/16 campos obrigatórios) |
| Caso de uso | IBM-análises e relatórios específicos | Gerenciamento de custos em várias nuvens e ferramentas FinOps |
Você pode exportar dados em ambos os formatos simultaneamente para dar suporte a diferentes casos de uso em sua organização.
Próximas etapas
Depois de exportar seus dados de uso no formato FOCUS, você pode:
- Configurar tags de alocação de custos para melhorar a atribuição de custos e o estorno
- Analise seu uso para identificar oportunidades de otimização de custos
- Implemente as práticas recomendadas do site FinOps para otimizar os custos da nuvem