Rastrear Relatórios de Recursos, Custo e Uso do Oracle Cloud Infrastructure com Views do Autonomous Database

O Oracle Autonomous Database rastreia os relatórios de recursos, custo e uso do Oracle Cloud Infrastructure. Você pode acessar esses relatórios usando as views do OCI.

Etapas de Pré-requisito para Usar as Views de Recursos do OCI

Descreve as etapas de pré-requisito que você deve executar para usar as views de recursos do OCI no Autonomous Database.

Observação

Somente o usuário ADMIN tem acesso às views de recursos do OCI por padrão. Para acessar essas views como outro usuário, o ADMIN deve conceder privilégios READ.

Para consultar uma view de recursos do OCI, faça o seguinte:

  1. Crie um grupo dinâmico que inclua sua instância do Autonomous Database e defina as políticas obrigatórias para acessar uma view.

    Por exemplo, a instância do Autonomous Database é especificada no parâmetro resource.id com um OCID:

    resource.id = '<your_Autonomous_Database_instance_OCID>'

    Cada view mostra os detalhes da política que você deve definir para consultar a view.

    Consulte Executar Pré-requisitos para Usar o Controlador de Recursos com o Autonomous Database para obter detalhes sobre como criar um grupo dinâmico e definir políticas.

    Por exemplo, para acessar todas as views, defina o seguinte:

    Define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq 
    Endorse dynamic-group <group-name> to read objects in tenancy usage-report
    Allow dynamic-group <group-name> to read buckets in tenancy
    Allow dynamic-group <group-name> to read autonomous-database in tenancy
    Allow dynamic-group <group-name> to read usage-budgets in tenancy
    Observação

    Não substitua o OCID dessa política por outro OCID. Esse OCID usage-report fornece os dados de uso do Oracle Cloud Infrastructure para sua tenancy.
  2. Verifique se o controlador de recursos está ativado para o usuário ADMIN na instância do Autonomous Database.
    SELECT owner, credential_name FROM dba_credentials 
       WHERE credential_name = 'OCI$RESOURCE_PRINCIPAL' AND owner = 'ADMIN';
     
    OWNER CREDENTIAL_NAME 
    ----- ---------------------
    ADMIN OCI$RESOURCE_PRINCIPAL

    Se o controlador de recursos não estiver ativado, ative-o:

    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();

    Consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure para obter mais informações.

  3. Execute uma consulta em uma view de recurso do OCI.

    Por exemplo:

    SELECT NAME, APPROXIMATESIZE FROM OCI_OBJECTSTORAGE_BUCKETS;
    SELECT * FROM OCI_USAGE_DATA;

OCI_AUTONOMOUS_DATABASES Exibir

OCI_AUTONOMOUS_DATABASES descreve todos os Autonomous Databases do Oracle Cloud Infrastructure na tenancy do Oracle Cloud Infrastructure obtidos da instância atual do Autonomous Database.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Allow dynamic-group <group-name> to read autonomous-database in tenancy

Essa política permite listar todos os Autonomous Databases em sua tenancy. Opcionalmente, você pode restringi-la para listar os Autonomous Databases em um determinado compartimento:

Allow dynamic-group <group-name> to read autonomous-database in compartment <compartment-name>
Coluna Tipo de dados Descrição
DISPLAYNAME VARCHAR2 O nome amigável do usuário do Autonomous Database.
REGION VARCHAR2 Nome da Região
COMPARTMENTID VARCHAR2 OCID do compartimento
ID VARCHAR2 O OCID do Autonomous Database
DBNAME VARCHAR2 O nome do banco de dados
LIFECYCLESTATE VARCHAR2 O estado atual do Autonomous Database
TIMECREATED VARCHAR2 A data e hora em que o Autonomous Database foi criado
DATASTORAGESIZEINTBS VARCHAR2 O volume de dados no banco de dados em terabytes
LICENSEMODEL VARCHAR2 O modelo de licença da Oracle que se aplica ao Autonomous Database
SERVICECONSOLEURL VARCHAR2 O URL da Console de Serviço para o Autonomous Database
APEXDETAILS CLOB Informações sobre o Oracle APEX Application Development
AREPRIMARYWHITELISTEDIPSUSED VARCHAR2 IPs Principais na Lista de Permissões
AUTONOMOUSCONTAINERDATABASEID VARCHAR2 OCID do Autonomous Container Database
AUTONOMOUSMAINTENANCESCHEDULETYPE VARCHAR2 Tipo de Programação de Manutenção
AVAILABLEUPGRADEVERSIONS VARCHAR2 Lista de versões do Oracle Database disponíveis para um upgrade do banco de dados
BACKUPCONFIG CLOB Configuração de Backup do Autonomous Database
CONNECTIONSTRINGS CLOB Strings de Conexão do Autonomous Database
CONNECTIONURLS CLOB URLs de Conexão do Autonomous Database
CPUCORECOUNT NUMBER O número de núcleos de OCPU a serem disponibilizados para o banco de dados
CUSTOMERCONTACTS CLOB Os Contatos do Cliente
DATASAFESTATUS VARCHAR2 Status do registro do Data Safe para este Autonomous Database
DATASTORAGESIZEINGBS NUMBER O volume de dados no banco de dados em gigabytes
DBVERSION VARCHAR2 A versão do Oracle Database para o Autonomous Database
DATAGUARDREGIONTYPE VARCHAR2 O tipo de região do Autonomous Data Guard do Autonomous Database
DBWORKLOAD VARCHAR2 O tipo de carga de trabalho do Autonomous Database
DEFINEDTAGS CLOB Tags definidas para o recurso
FAILEDDATARECOVERYINSECONDS NUMBER Indica o número de segundos de perda de dados para um failover do Autonomous Data Guard
FREEFORMTAGS CLOB Tags de formato livre para o recurso
INFRASTRUCTURETYPE VARCHAR2 O tipo de infraestrutura ao qual esse recurso pertence
ISACCESSCONTROLENABLED VARCHAR2 Indica se o controle de acesso no nível do banco de dados está ativado
ISAUTOSCALINGENABLED VARCHAR2 Indica se o dimensionamento automático está ativado para o Autonomous Database
ISDATAGUARDENABLED VARCHAR2 Indica se o Autonomous Database tem um Autonomous Data Guard local ativado
ISDEDICATED VARCHAR2 Verdadeiro se o banco de dados usar a infraestrutura dedicada do Exadata
ISFREETIER VARCHAR2 Indica se este é um recurso Always Free
ISMTLSCONNECTIONREQUIRED VARCHAR2 Indica se o Autonomous Database exige conexões mTLS
ISPREVIEW VARCHAR2 Indica se a versão do Autonomous Database é de visualização
ISREFRESHABLECLONE VARCHAR2 Indica se o Autonomous Database é um clone atualizável
KEYHISTORYENTRY CLOB Entrada do Histórico de Chaves
KEYSTOREID VARCHAR2 O OCID do armazenamento de chaves
KEYSTOREWALLETNAME VARCHAR2 O nome da wallet do Oracle Cloud Infrastructure Vault
KMSKEYID VARCHAR2 O OCID do contêiner de chaves que é usado como chave de criptografia principal
KMSKEYLIFECYCLEDETAILS VARCHAR2 Detalhes do ciclo de vida da chave gerenciado pelo cliente
LIFECYCLEDETAILS VARCHAR2 Informações sobre o estado do ciclo de vida atual
NSGIDS CLOB Uma lista dos OCIDs dos grupos de segurança de rede NSGs
OCPUCOUNT NUMBER O número de núcleos de OCPU a serem disponibilizados para o banco de dados
OPENMODE VARCHAR2 O modo aberto do Autonomous Database
OPERATIONSINSIGHTSSTATUS VARCHAR2 Status do OCI Ops Insights para este Autonomous Database
PEERDBIDS VARCHAR2 A lista de OCIDs de bancos de dados standby localizados no Autonomous Data Guard
PERMISSIONLEVEL CLOB O nível de permissão do Autonomous Database
PRIVATEENDPOINT VARCHAR2 O ponto final privado do recurso
PRIVATEENDPOINTIP VARCHAR2 O endereço IP de ponto final privado do recurso
PRIVATEENDPOINTLABEL VARCHAR2 O label do ponto final privado do recurso
REFRESHABLEMODE VARCHAR2 O modo de atualização do clone
REFRESHABLESTATUS VARCHAR2 O status de atualização do clone
ROLE VARCHAR2 A atribuição do Autonomous Data Guard
SOURCEID VARCHAR2 O OCID do Autonomous Database de origem que foi clonado
SQLWEBDEVELOPERURL VARCHAR2 O URL do Database Actions (SQL Developer Web) para o Autonomous Database
STANDBYDB CLOB Resumo do Stand-by do Autonomous Database
STANDBYWHITELISTEDIPS CLOB A lista de controle de acesso IPs do cliente
SUBNETID VARCHAR2 OCID da sub-rede à qual o recurso está associado
SUPPORTEDREGIONSTOCLONETO CLOB A lista de regiões que suportam a criação do Autonomous Data Guard
SYSTEMTAGS CLOB Tags do sistema para este recurso
TIMEDATAGUARDROLECHANGED VARCHAR2 A data e a hora em que a atribuição do Autonomous Data Guard foi alternada
TIMEDELETIONOFFREEAUTONOMOUSDATABASE NUMBER Exclusão de tempo do Autonomous Database Grátis
TIMELOCALDATAGUARDENABLED VARCHAR2 A data e a hora em que o Autonomous Data Guard foi ativado para o Autonomous Database
TIMEMAINTENANCEBEGIN VARCHAR2 A data e a hora em que a manutenção começará
TIMEMAINTENANCEEND VARCHAR2 A data e a hora em que a manutenção terminará
TIMEOFLASTFAILOVER VARCHAR2 O timestamp da última operação de failover
TIMEOFLASTREFRESH VARCHAR2 A data e a hora da última atualização
TIMEOFLASTREFRESHPOINT VARCHAR2 O timestamp do ponto de atualização
TIMEOFLASTSWITCHOVER VARCHAR2 O timestamp da última operação de switchover do Autonomous Database
TIMEOFNEXTREFRESH VARCHAR2 A data e a hora da próxima atualização
TIMERECLAMATIONOFFREEAUTONOMOUSDATABASE VARCHAR2 A data e a hora do banco de dados Always Free
USEDDATASTORAGESIZEINTBS NUMBER O volume de armazenamento que foi usado em terabytes
VAULTID VARCHAR2 O OCID do Oracle Cloud Infrastructure Vault
WHITELISTEDIPS CLOB A lista de controle de acesso IPs do cliente

OCI_BUDGET_ALERT_RULES Exibir

OCI_BUDGET_ALERT_RULES descreve todas as regras de alerta de orçamento do Oracle Cloud Infrastructure na tenancy do Oracle Cloud Infrastructure obtidas da instância atual do Autonomous Database.

As consultas nessa view só retornarão resultados se você tiver orçamentos e alertas de orçamento criados em sua tenancy.

Consulte Visão Geral de Orçamentos para obter mais informações.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Allow dynamic-group <group-name> to read usage-budgets in tenancy

Essa política permite listar o resumo e os alertas de orçamento em sua tenancy (se você criou um orçamento e um alerta de orçamento). Você pode restringir o resultado retornado consultando a view para um determinado compartimento:

Allow dynamic-group <group-name> to read usage-budgets in compartment <compartment-name>
Coluna Tipo de dados Descrição
BUDGETID VARCHAR2 O OCID do orçamento
REGION VARCHAR2 Nome da região
COMPARTMENTID VARCHAR2 O ID do compartimento ao qual o bucket tem autorização
DEFINEDTAGS CLOB Tags definidas para o recurso
DESCRIPTION VARCHAR2 A descrição da regra de alerta
DISPLAYNAME VARCHAR2 O nome da regra de alerta
FREEFORMTAGS CLOB Tags de formato livre para o recurso
ID VARCHAR2 O OCID da regra de alerta
LIFECYCLESTATE VARCHAR2 O estado atual da regra de alerta
MESSAGE VARCHAR2 A mensagem personalizada que será enviada quando o alerta for acionado
RECIPIENTS VARCHAR2 O público-alvo que recebe o alerta quando ele é acionado
THRESHOLD NUMBER O limite para acionar o alerta
THRESHOLDTYPE VARCHAR2 O tipo de limite
TIMECREATED VARCHAR2 O horário em que o orçamento foi criado
TIMEUPDATED VARCHAR2 O horário em que o orçamento foi atualizado
TYPE VARCHAR2 Tipos ACTUAL ou FORECAST de acionadores de alerta
VERSION NUMBER Versão da regra de alerta

OCI_BUDGET_SUMMARY Exibir

OCI_BUDGET_SUMMARY descreve todos os resumos de orçamento do Oracle Cloud Infrastructure na tenancy do Oracle Cloud Infrastructure obtidos da instância atual do Autonomous Database.

As consultas nessa view só retornarão resultados se você tiver orçamentos criados em sua tenancy.

Consulte Visão Geral de Orçamentos para obter mais informações.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Allow dynamic-group <group-name> to read usage-budgets in tenancy

Essa política permite listar o resumo e os alertas de orçamento em sua tenancy (se você criou um orçamento e um alerta de orçamento). Você pode restringir o resultado retornado consultando a view para um determinado compartimento:

Allow dynamic-group <group-name> to read usage-budgets in compartment <compartment-name>
Coluna Tipo de dados Descrição
REGION VARCHAR2 Nome da região
COMPARTMENTID VARCHAR2 OCID do compartimento
AMOUNT NUMBER O valor do orçamento, expresso na moeda de um cartão de tarifas
DEFINEDTAGS CLOB Tags definidas para o recurso
FREEFORMTAGS CLOB Tags de formato livre para o recurso
DISPLAYNAME VARCHAR2 O nome para exibição do orçamento.
LIFECYCLESTATE VARCHAR2 O estado atual do orçamento
ACTUALSPEND NUMBER O gasto real em moeda para o ciclo de orçamento atual
ALERTRULECOUNT NUMBER O número total de regras de alerta no orçamento
BUDGETPROCESSINGPERIODSTARTOFFSET NUMBER O número de dias compensados a partir do primeiro dia do mês, no qual o período de processamento do orçamento começa
DESCRIPTION VARCHAR2 A descrição do orçamento
FORECASTEDSPEND NUMBER O gasto previsto em moeda até o final do ciclo de orçamento atual.
ID VARCHAR2 O OCID do orçamento
RESETPERIOD VARCHAR2 O período de redefinição do orçamento
TARGETS CLOB A lista de destinos nos quais o orçamento é aplicado.
TARGETCOMPARTMENTID VARCHAR2 OCID do compartimento de destino
TARGETTYPE VARCHAR2 O tipo de destino no qual o orçamento é aplicado
TIMECREATED VARCHAR2 O horário em que o orçamento foi criado
TIMESPENDCOMPUTED VARCHAR2 O horário em que o gasto do orçamento foi calculado pela última vez
TIMEUPDATED VARCHAR2 O horário em que o orçamento foi atualizado
VERSION VARCHAR2 A versão do orçamento

OCI_COST_DATA Exibir

OCI_COST_DATA descreve todos os dados de custo do Oracle Cloud Infrastructure para a tenancy do Oracle Cloud Infrastructure obtidos da instância atual do Autonomous Database.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq 
Endorse dynamic-group <group-name> to read objects in tenancy usage-report
Observação

Não substitua o OCID dessa política por outro OCID. Esse OCID usage-report fornece os dados de uso do Oracle Cloud Infrastructure para sua tenancy.
Coluna Tipo de dados Descrição
REFERENCE_NUMBER VARCHAR2 Número de Referência/Identificador de linha usado para depuração e correções
TENANT_ID VARCHAR2 O identificador (OCID) do tenant do Oracle Cloud Infrastructure
INTERVAL_USAGE_START TIMESTAMP O horário inicial do intervalo de uso do recurso no UTC
INTERVAL_USAGE_END TIMESTAMP O horário final do intervalo de uso do recurso no UTC
SERVICE_NAME VARCHAR2 O serviço em que o recurso se encontra
COMPARTMENT_ID VARCHAR2 O ID do compartimento que contém o recurso
COMPARTMENT_NAME VARCHAR2 O nome do compartimento que contém o recurso
REGION VARCHAR2 A região que contém o recurso
AVAILABILITY_DOMAIN VARCHAR2 O domínio de disponibilidade que contém o recurso
RESOURCE_ID VARCHAR2 O identificador do recurso.
BILLED_QUANTITY VARCHAR2 A quantidade do recurso que foi faturada durante o intervalo de uso
BILLED_QUANTITY_OVERAGE VARCHAR2 O volume de uso cobrado
SUBSCRIPTION_ID VARCHAR2 Um identificador exclusivo associado ao compromisso ou à inscrição
PRODUCT_SKU VARCHAR2 O Número do Item do recurso na linha
PRODUCT_DESCRIPTION VARCHAR2 A descrição do produto para o recurso na linha
UNIT_PRICE VARCHAR2 O custo faturado para cada unidade do recurso usada
UNIT_PRICE_OVERAGE VARCHAR2 O custo por unidade de uso excedente de um recurso
MY_COST VARCHAR2 O custo cobrado para esta linha de uso
MY_COST_OVERAGE VARCHAR2 O custo faturado do uso excedente de um recurso
CURRENCY_CODE VARCHAR2 O código da moeda da sua tenancy
BILLING_UNIT_READABLE VARCHAR2 A medida da unidade associada ao uso/billedQuantity na linha
SKU_UNIT_DESCRIPTION VARCHAR2 A unidade usada para medir a quantidade faturada
OVERAGE_FLAG CHAR Flag usado para uso excedente
IS_CORRECTION VARCHAR2 Usado se a linha atual for uma correção
BACK_REFERENCE_NUMBER VARCHAR2 Referência de emendas e correções de dados
CREATED_BY VARCHAR2 O usuário que criou o serviço
CREATED_ON TIMESTAMP O horário em que o serviço foi criado
FREE_TIER_RETAINED VARCHAR2 O serviço é mantido na camada gratuita

OCI_OBJECTSTORAGE_BUCKETS Exibir

OCI_OBJECTSTORAGE_BUCKETS descreve todos os buckets de armazenamento de objetos do Oracle Cloud Infrastructure na tenancy do Oracle Cloud Infrastructure obtidos da instância atual do Autonomous Database.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Allow dynamic-group <group-name> to read buckets in tenancy

Essa política permite listar os buckets de armazenamento de objetos em sua tenancy. Você pode restringir o resultado retornado consultando essa view para um determinado compartimento:

Allow dynamic-group <group-name> to read buckets in compartment <compartment-name>
Coluna Tipo de dados Descrição
REGION VARCHAR2 Nome da região
COMPARTMENTID VARCHAR2 O ID do compartimento ao qual o bucket tem autorização
NAMESPACE VARCHAR2 O namespace do Armazenamento de Objetos no qual o bucket reside
APPROXIMATECOUNT NUMBER O número aproximado de objetos no bucket
APPROXIMATESIZE NUMBER O tamanho total aproximado em bytes de todos os objetos no bucket
AUTOTIERING VARCHAR2 O status do armazenamento automático em camadas no bucket
CREATEDBY VARCHAR2 O OCID do usuário que criou o bucket
DEFINEDTAGS CLOB Tags definidas para o recurso
FREEFORMTAGS CLOB Tags de formato livre para o recurso
ETAG VARCHAR2 A tag de entidade (ETag) do bucket
ID VARCHAR2 O OCID do bucket
ISREADONLY VARCHAR2 Se esse bucket é ou não somente para leitura
KMSKEYID VARCHAR2 O OCID de uma chave de criptografia principal
METADATA VARCHAR2 Chaves e valores arbitrários de string para metadados definidos pelo usuário
NAME VARCHAR2 O nome do bucket
OBJECTEVENTSENABLED VARCHAR2 Se eventos são emitidos ou não para alterações de estado do objeto nesse bucket
OBJECTLIFECYCLEPOLICYETAG VARCHAR2 A tag de entidade (ETag) da política de ciclo de vida do objeto ao vivo no bucket
PUBLICACCESSTYPE VARCHAR2 O tipo de acesso público ativado nesse bucket
REPLICATIONENABLED VARCHAR2 Se esse bucket é ou não uma origem de replicação
STORAGETIER VARCHAR2 O tipo de camada de armazenamento designado ao bucket
TIMECREATED VARCHAR2 A data e a hora em que o bucket foi criado
VERSIONING VARCHAR2 O status do controle de versão no bucket

OCI_USAGE_DATA Exibir

OCI_USAGE_DATA descreve todos os dados de uso do Oracle Cloud Infrastructure para a tenancy do Oracle Cloud Infrastructure obtidos da instância atual do Autonomous Database.

Observação

Você pode usar relatórios de uso do OCI e a exibição OCI_USAGE_DATA para obter informações sobre custo e uso antes de 31 de janeiro de 2025. Os relatórios de custo e uso do OCI estão obsoletos. Você pode continuar acessando seus arquivos CSV de relatório de uso existentes até 31 de julho de 2025. Consulte Relatórios de Custo e Uso para obter mais informações.

Para consultar essa exibição, você precisa de um grupo dinâmico que inclua sua instância do Autonomous Database e a seguinte política definida nesse grupo dinâmico:

Define tenancy usage-report as ocid1.tenancy.oc1..aaaaaaaaned4fkpkisbwjlr56u7cj63lf3wffbilvqknstgtvzub7vhqkggq
Endorse dynamic-group <group-name> to read objects in tenancy usage-report
Observação

Não substitua o OCID dessa política por outro OCID. Esse OCID usage-report fornece os dados de custo e uso do Oracle Cloud Infrastructure para a sua tenancy.
Coluna Tipo de dados Descrição
REFERENCE_NUMBER VARCHAR2 Número de Referência/Identificador de linha usado para depuração e correções
TENANT_ID VARCHAR2 O identificador (OCID) do tenant do Oracle Cloud Infrastructure
INTERVAL_USAGE_START TIMESTAMP O horário inicial do intervalo de uso do recurso no UTC
INTERVAL_USAGE_END TIMESTAMP O horário final do intervalo de uso do recurso no UTC
SERVICE_NAME VARCHAR2 O serviço em que o recurso se encontra
RESOURCE_NAME VARCHAR2 O nome do recurso usado pelo sistema de medição
COMPARTMENT_ID VARCHAR2 O ID do compartimento que contém o recurso
COMPARTMENT_NAME VARCHAR2 O nome do compartimento que contém o recurso
REGION VARCHAR2 A região que contém o recurso
AVAILABILITY_DOMAIN VARCHAR2 O domínio de disponibilidade que contém o recurso
RESOURCE_ID VARCHAR2 O identificador do recurso.
CONSUMED_QUANTITY VARCHAR2 A quantidade do recurso que foi consumida durante o intervalo de uso
BILLED_QUANTITY VARCHAR2 A quantidade do recurso que foi faturada durante o intervalo de uso
CONSUMED_QUANTITY_UNITS VARCHAR2 A unidade da quantidade consumida e da quantidade faturada
CONSUMED_QUANTITY_MEASURE VARCHAR2 A medida para a quantidade consumida e a quantidade faturada
IS_CORRECTION VARCHAR2 Usado se a linha atual for uma correção
BACK_REFERENCE_NUMBER VARCHAR2 Referência de emendas e correções de dados
CREATED_BY VARCHAR2 O usuário que criou o serviço
CREATED_ON TIMESTAMP O horário em que o serviço foi criado
FREE_TIER_RETAINED VARCHAR2 O serviço é mantido na camada gratuita