OCI

Abrir na plataforma

Página dedicada às instâncias Oracle Cloud Infrastructure (OCI): tenancies e compartments observados pela plataforma a partir de uma credencial de API com permissão de leitura. A coleta percorre os serviços (Compute, Block Volume, Object Storage, VCN, Load Balancer, etc), normaliza o inventário e publica métricas de uso, disponibilidade, consumo e cota.

A página em si é o inventário das contas/compartments cadastrados, com estado consolidado da coleta e atalho para o detalhe gráfico. O cadastro novo acontece direto aqui, diferente de Armazenamento, que só lista.

Quem usa

• SRE e Plantão: querem ver rapidamente se a tenancy está acessível, se algum recurso caiu e se há alerta aberto vindo da OCI.
• Time de Cloud: acompanha consumo agregado, cotas próximas do teto e custo anormal por compartment.
• Time de Plataforma: cadastra novas contas, gerencia credenciais e ajusta o coletor responsável.

Se o seu papel não envolve OCI diretamente, o que importa aqui é entender que essas instâncias geram alertas que aparecem em Alertas como qualquer outro recurso.

A lista

Acessada por Cloud → OCI (URL /oci-monitoring). A tabela traz uma linha por instância cadastrada. Tenant novo aparece vazio.

Coluna	O que mostra
Nome da Instância	Identificador amigável da conta/compartment OCI dentro da plataforma (ex: oci-prod-account, oci-sandbox).
Endereço	Endpoint pelo qual a plataforma alcança a OCI: região da API (identity.sa-saopaulo-1.oci.oraclecloud.com) ou URL de identidade equivalente.
Tags	Etiquetas livres para agrupar (ex: producao, billing, sandbox).
Status	Indicador de saúde da última coleta: verde quando a credencial está válida e a API respondeu, vermelho quando houve falha de autenticação ou timeout.
Ações	Menu com Editar, Excluir e Abrir detalhes (drill-down para gráficos e inventário).

Acima da tabela ficam os controles padrão: campo de busca (filtra por nome, endereço ou tag), botão Atualizar, Exportar CSV e paginação no rodapé.

Ordenação

Clique no cabeçalho da coluna para ordenar. A ordem persiste enquanto a sessão estiver aberta.

Cadastrar uma instância

O botão Adicionar instância abre um modal com os campos abaixo. Antes de cadastrar, garanta os pré-requisitos:

Pré-requisitos

1. Usuário de API criado no OCI IAM, dedicado à observabilidade (não use credencial pessoal).
2. Chave de API gerada para esse usuário (par público/privado em PEM).
3. Policy de leitura atribuída ao grupo do usuário. Privilégio mínimo recomendado:

   Allow group SP1-Observability to read all-resources in tenancy
   Allow group SP1-Observability to read metrics in tenancy
   Allow group SP1-Observability to read usage-budgets in tenancy
   

   Se a política da sua empresa não permite read all-resources, restrinja por compartment, mas saiba que o inventário virá parcial.
4. OCID da tenancy e OCID do usuário anotados (ex: ocid1.tenancy.oc1..aaa<exemplo>, ocid1.user.oc1..aaa<exemplo>).
5. Fingerprint da chave pública carregada no console OCI.
6. Região home definida (ex: sa-saopaulo-1).

Campos do modal

Campo	O que preencher
Nome da Instância	Como ela vai aparecer na lista. Use algo descritivo: oci-prod-account, oci-cliente-x.
Tenancy OCID	OCID da tenancy raiz.
User OCID	OCID do usuário de API criado para a plataforma.
Região	Região home da tenancy (ex: sa-saopaulo-1, us-ashburn-1).
Fingerprint	Fingerprint da chave pública.
Chave Privada (PEM)	Conteúdo da chave privada. Armazenada cifrada.
Compartments	Lista de compartments a coletar. Em branco = todos visíveis para o usuário.
Coletor	Qual coletor (hub) é responsável pela coleta. Em ambientes com vários coletores, escolha o que tem saída pra internet liberada pra OCI.
Tags	Etiquetas livres.

Após salvar, a primeira coleta acontece em poucos minutos. O status fica em Aguardando até o ciclo terminar e então transita para verde ou vermelho.

Privilégio mínimo importa

Resista à tentação de usar uma policy manage. A plataforma só precisa ler. Conceder escrita aumenta a superfície de risco sem nenhum ganho funcional.

Escolha do coletor

O coletor que processa OCI precisa de:

• Saída HTTPS pros endpoints regionais (*.oraclecloud.com).
• Relógio sincronizado (NTP), porque a assinatura das requisições à API OCI é sensível a drift.
• Versão do coletor que inclua o conector OCI. Em caso de dúvida, confirme com o suporte da SpecialOne.

Detalhe da instância

Ao clicar em Abrir detalhes (ou na linha) você vai pra página de gráficos da instância. O drill-down é organizado por serviço:

Compute (VMs)

• Lista de instâncias Compute com shape, OCPUs, memória, estado (Running/Stopped/Terminated) e uptime.
• Métricas por VM: CPU, memória, rede in/out, disco.
• Atalho pra abrir o host correspondente em Hosts quando ele também é monitorado por agente.

Block Storage

• Volumes em uso, tamanho provisionado, IOPS médios, latência.
• Boot volumes e block volumes listados separadamente.
• Snapshots e backups recentes.

Object Storage

• Buckets, tamanho total armazenado, número de objetos, tier (Standard/Archive).
• Tráfego de leitura/escrita agregado por bucket.

Rede (VCN)

• VCNs, subnets, security lists, NAT/IGW, Load Balancers com listeners e backends.
• Tráfego por interface, conexões ativas.

Cota e custo

• Consumo do mês corrente por serviço.
• Cotas com indicador de quanto falta pro teto (vCPU, IPs, etc).
• Tendência projetando estouro quando aplicável.

Alertas vinculados

Bloco final com os alertas abertos relacionados à instância. Cada linha leva ao detalhe em Alertas.

Editar e gerenciar

O menu Ações de cada linha traz três operações.

Editar

Reabre o modal de cadastro com os valores atuais (chave privada vem mascarada, só substitua se for trocar). Use pra:

• Ajustar tags.
• Mudar a lista de compartments monitorados.
• Trocar a chave de API quando rotacionar credencial.
• Mover a instância pra outro coletor.

Alterações entram em vigor no próximo ciclo de coleta.

Excluir

Remove a instância e para a coleta. O histórico de métricas e alertas dela permanece pra consulta histórica por 90 dias, depois é purgado. Não é reversível: pra voltar, cadastre de novo.

Confirme antes de excluir

Excluir em produção significa apagar o monitoramento ativo. Garanta que existe outra cobertura (ou que a tenancy foi descomissionada) antes de confirmar.

Drill-down (abrir detalhes)

Mesmo destino do clique na linha. Útil quando você quer abrir em outra aba pelo menu de contexto do navegador.

Alertas típicos

Os perfis de monitoramento padrão para OCI já trazem regras prontas. Severidades seguem o padrão da plataforma: Crítico, Alto, Médio, Informação. Os mais comuns:

• Tenancy inacessível (Crítico): credencial falhou ou API não respondeu em 3 ciclos seguidos.
• Recurso indisponível (Alto): instância Compute em estado anormal (stopping prolongado, terminating travado).
• Cota próxima do limite (Médio): consumo passou de 80% do teto da cota (vCPU por região, IPs públicos, buckets).
• Volume sem espaço (Alto): block volume com uso acima de 90%.
• Backup falhou (Médio): última política de backup automática não rodou ou retornou erro.
• Custo anormal (Médio): gasto do dia atual destoou da média móvel dos últimos 7 dias.
• Load Balancer sem backend saudável (Crítico): todos os backends de um listener em estado Critical.
• Certificado próximo do vencimento (Médio): certificados gerenciados na OCI com menos de 30 dias pra expirar.

Esses alertas seguem o mesmo fluxo de roteamento por regras de notificação e podem ser silenciados via manutenção.

Limites

• Paginação da API OCI: a coleta paga em páginas de 100 itens por chamada. Tenancies muito grandes (>5 mil recursos) podem levar alguns minutos pra um ciclo completo.
• Timeout de coleta: cada chamada à API tem teto de 60 segundos. Se uma região estiver lenta, aquele serviço fica marcado como parcial naquele ciclo, sem invalidar o resto.
• Intervalo mínimo: ciclo de coleta de inventário a cada 5 minutos. Métricas instantâneas (CPU, memória) seguem o intervalo do perfil de monitoramento aplicado.
• Compartments: até 200 compartments por instância. Acima disso, divida em duas entradas (ex: por linha de negócio).
• Throttling: a OCI aplica rate limit por tenant. Se o coletor recebe HTTP 429 com frequência, o ciclo é alongado automaticamente.
• Histórico: dados detalhados ficam por 90 dias. Agregados diários por 13 meses.

Próximos passos

• Hosts

  ---

  VMs Compute do OCI que também rodam agente aparecem em Hosts.

  Página de Hosts

• Alertas

  ---

  Como os alertas vindos da OCI são apresentados, roteados e tratados.

  Ver Alertas