Pessoal ou da empresa: é por ele que você entra e recebe os convites.
App autenticador
Google Authenticator, 1Password, Authy ou outro.
Acesso ao cluster
kubectl e helm apontados para o cluster que você vai conectar.
Passo 01 · Começar
Criar conta ou aceitar convite
~3 minQuem cria a organização ou quem foi convidado
Se sua empresa ainda não usa o Immuno Ops, crie a conta: você vira administrador da organização. Se alguém da sua empresa já usa, peça um convite. Não crie uma segunda conta para a mesma empresa.
Criar uma conta nova
Na tela de login, clique em Criar conta →.
Informe seu e-mail e clique em Enviar código →.
Digite o código de 6 dígitos que chegou no e-mail. Não chegou? Espere o contador e use Reenviar.
Preencha nome completo e senha (8 ou mais caracteres, com maiúscula, minúscula, número e símbolo) e clique em Criar minha conta →.
Responda as perguntas rápidas: WhatsApp, empresa e cargo, tamanho do cluster e o que dói mais hoje.
Confira os dados e clique em Concluir cadastro. Você entra direto no console.
app.immunoops.io/ui/signup
IMMUNO.OPS
O que dói mais hoje?
Custo de nuvem fora de controle
Alertas contraditórios / ruído
Falta de visão multi-cluster
Incidentes sem causa raiz clara
Continuar →← Voltar
Cadastro · pergunta de qualificação
Aceitar um convite
app.immunoops.io/ui/accept-invite
IMMUNO.OPS
Aceitar convite
Ana Souza convidou você para a organização Acme com o papel Operador.
A tela mostra quem convidou, a organização e o seu papel.
Defina nome e senha e clique em Aceitar e entrar.
✓
Já tem conta?Se o seu e-mail já usa o Immuno Ops em outra organização, clique em Entrar para aceitar. A nova organização entra na conta que você já usa, sem outra senha.
!
Convite expirado ou revogadoConvites têm prazo. Se a tela disser que expirou, foi revogado ou já foi usado, peça ao administrador para reenviar.
Se você ativou a verificação em duas etapas, digite o código de 6 dígitos do app autenticador e clique em Verificar código.
Se o seu e-mail tem acesso a mais de uma organização, escolha a organização padrão. Ela abre sempre que você entra, e dá para trocar pelo seletor de organização, no canto superior direito.
Logo depois do cadastro, e enquanto nenhum serviço estiver conectado, um tour guiado abre por cima da Visão Geral. Ele ilumina cada item do menu e mostra onde conectar seus serviços.
app.immunoops.io/ui/
IMMUNO.OPS
Administrar▾
Clusters
VMs
Cloud Run
Instrumentação
Equipe
Empresa
Investigar▸
Analisar▸
Operar▾
Visão Geral
VRVanessa R.⚿
OPERAR / VISÃO GERALPTAAcme ▾✦
Passo 2 de 7
Seus serviços ficam em Clusters
É aqui que você conecta e acompanha tudo o que o Immuno Ops monitora.
PularVoltarIr para Clusters
Tour · passo que ilumina Clusters no menu
Passo
O que mostra
1
Boas-vindas
2 · 3
Clusters: onde ficam e como conectar
4 · 5
Cloud Run: onde fica e como registrar
6
Instrumentar a aplicação com OpenTelemetry
7
VMs e a aba Suspensão
✓
Pode pularPular ou Esc fecham o tour. Ele volta no próximo login enquanto nada estiver conectado. Os passos 05 a 07 cobrem o mesmo caminho com mais detalhe.
O menu da esquerda tem quatro grupos, nesta ordem: Administrar, Investigar, Analisar e Operar. Clique no nome do grupo para abrir os itens; o grupo da tela em que você está já fica aberto. No rodapé do menu ficam seu usuário e o atalho para Segurança da conta.
app.immunoops.io/ui/
IMMUNO.OPS
Administrar▸
Investigar▸
Analisar▸
Operar▾
Visão Geral
VRVanessa R.⚿
OPERAR / VISÃO GERALPTAAcme ▾✦
Visão Geral do Immuno Ops
Status operacional unificado entre workloads, confiabilidade, sinais de custo e saúde da plataforma.
Menu lateral com os quatro grupos e a barra do topo
Grupo
Itens
Administrar
Clusters, VMs, Cloud Run, Instrumentação, Equipe e Empresa.
Investigar
Workloads, Alertas e Incidentes e Observabilidade, com Dashboards dentro de Observabilidade.
Analisar
Kubernetes FinOps e FOCUS Normalizer.
Operar
Visão Geral: status, alertas e clusters. É a tela que abre depois do login.
i
A barra do topoMostra onde você está, por exemplo ADMINISTRAR / CLUSTERS. À direita ficam o idioma, o seletor de organização e o agente de IA.
i
Seu papel define o que apareceQuem tem papel Leitura vê painéis, alertas e custos, mas não os botões de conectar ou convidar. Equipe e Empresa só aparecem para quem tem permissão.
Antes, a conta de nuvemVM e Cloud Run exigem ao menos uma conta cadastrada. Cloud Run exige uma conta GCP. Sem ela, Conectar VM e Conectar Cloud Run abrem Adicionar conta. O cadastro da conta está em Conta de nuvem. Os papéis no projeto do recurso estão em Permissões de VM e Cloud Run.
Cluster
Instala um agent
Helm no cluster. Traz workloads, métricas, logs e traces.
Cloud Run
Nada para instalar
As métricas vêm do Cloud Monitoring do seu projeto GCP.
VM
Agente no host
Comando de instalação na VM do Compute Engine.
Cloud Run
Vá em Administrar › Cloud Run e clique em Conectar Cloud Run.
Informe nome, ID do projeto GCP e região. Clique em Registrar.
VMs
Vá em Administrar › VMs e clique em Conectar VM.
Informe nome, ID do projeto GCP e zona. Clique em Registrar.
Copie o comando em Instalar o agente, rode na VM e clique em Concluir.
app.immunoops.io/ui/cloud-run
IMMUNO.OPS
Administrar▾
Clusters
VMs
Cloud Run
Instrumentação
Equipe
Empresa
Investigar▸
Analisar▸
Operar▸
VRVanessa R.⚿
ADMINISTRAR / CLOUD RUNPTAAcme ▾✦
Cloud Run
☁
Registrar um serviço Cloud Run
checkout-api
acme-prod-123
southamerica-east1
CancelarRegistrar
Administrar › Cloud Run · registro de serviço
✓
Economize com a aba SuspensãoEm VMs › Suspensão, use Nova política para ligar e desligar VMs por horário, por exemplo desligar staging fora do expediente. O acesso para isso está em Permissões da VM.
Permissões de VM e Cloud Run
Quem libera no Google Cloud é alguém que altera o IAM do projeto do recurso. A conta é [email protected], a conta da API, que também lê o billing em Conta de nuvem. Se a organização bloqueia contas de fora, inclua o customer ID C011tigzz neste projeto também, do mesmo jeito descrito em Se a organização bloqueia contas de fora.
Cloud Run
O Immuno Ops lê o Cloud Monitoring e o Cloud Logging do projeto. Nada é instalado no container. No projeto GCP do serviço, essa conta precisa de dois papéis de leitura:
Papel
ID
Onde
Para quê
Monitoring Viewer
roles/monitoring.viewer
projeto do serviço
Requisições, latência, CPU, memória e instâncias
Logs Viewer
roles/logging.viewer
projeto do serviço
Logs de stdout, stderr e requisições
gcloud projects add-iam-policy-binding PROJETO --member="serviceAccount:[email protected]" --role="roles/monitoring.viewer"
gcloud projects add-iam-policy-binding PROJETO --member="serviceAccount:[email protected]" --role="roles/logging.viewer"
Troque PROJETO pelo ID do projeto do serviço. No exemplo da tela, é acme-prod-123. Rode os dois num terminal autenticado no Google Cloud.
Sem o papel de Monitoring, os números do serviço ficam sem leitura. Sem o papel de Logging, a tela de logs cita roles/logging.viewer e o projeto. Se a tela disser que a coleta de logs ainda não está habilitada para a conta, peça ao suporte para habilitá-la: o papel prepara o acesso, e a coleta só começa depois dessa liberação.
VM
Métricas e logs da VM saem do agente instalado no host. Quem instala precisa rodar o comando na máquina, e a VM precisa de saída HTTPS para app.immunoops.io.
A aba Suspensão liga e desliga a instância no Compute Engine. Para isso, a mesma conta precisa listar, iniciar e parar instâncias nesse projeto. Crie um papel só com essas três permissões e conceda à conta:
gcloud iam roles create immunoOpsVmPower --project=PROJETO --title="Immuno Ops VM power" --permissions=compute.instances.list,compute.instances.start,compute.instances.stop --stage=GA
gcloud projects add-iam-policy-binding PROJETO --member="serviceAccount:[email protected]" --role="projects/PROJETO/roles/immunoOpsVmPower"
Troque PROJETO pelo ID do projeto da VM. O papel cobre listar, iniciar e parar. A coleta do agente segue com a instalação no host.
Conta de nuvem
A conta é somente leitura do billing. Nada é criado nem alterado nos recursos da nuvem. Quem cadastra no Immuno Ops é o Administrador. Quem libera no Google Cloud é alguém que altera o IAM do dataset de billing e, se a organização restringe domínios, a política do projeto.
O caminho é Infraestrutura, aba Contas (app.immunoops.io/ui/infrastructure?tab=contas). Uma conta GCP traz o custo do projeto. Uma conta AWS ou Azure conta como “ao menos uma conta” para uma VM, mas não substitui a conta GCP do Cloud Run.
Ativar o export no Google Cloud
No Google Cloud, abra a conta de faturamento que paga os projetos e vá em Exportação de faturamento › Exportação para o BigQuery.
Ative o export de custo de uso (padrão ou detalhado). A tabela do Immuno Ops é essa, com as colunas de custo do Cloud Billing. Não use uma tabela no formato FOCUS.
Escolha o projeto e o dataset. O Google cria uma tabela com nome no formato gcp_billing_export_v1_… ou gcp_billing_export_resource_v1_….
Anote o identificador completo, no formato projeto.dataset.tabela. Exemplo ilustrativo: acme-billing.billing_export.gcp_billing_export_v1_012345_ABCDE1_234567.
i
A primeira linha demoraO export pode levar algumas horas para aparecer. O teste de conexão aceita a tabela vazia; o status só fica em dia quando chega custo recente.
Cadastrar no Immuno Ops
Vá em Infraestrutura, aba Contas, e clique em Adicionar conta.
Escolha GCP.
Informe o ID do projeto e a Tabela do billing export (projeto.dataset.tabela). O nome é opcional.
Clique em Adicionar conta.
i
Conta GCP antiga, sem tabelaO cartão mostra Sem tabela. Abra a conta, informe a tabela e clique em Salvar tabela. A partir daí valem os mesmos comandos e o mesmo teste.
Permissões no dataset
No dataset do export, as duas contas de serviço do Immuno Ops precisam do papel BigQuery Data Viewer (roles/bigquery.dataViewer). É leitura. Não conceda papéis de edição, de administração do projeto nem de faturamento.
Depois de salvar a tabela, a conta no console mostra os dois comandos já com o dataset preenchido. Copie de lá. A forma, com PROJETO:DATASET no lugar do dataset (os dois primeiros trechos de projeto.dataset.tabela, separados por :), é:
Rode os dois num terminal autenticado no Google Cloud, com permissão para alterar o IAM desse dataset. No exemplo ilustrativo, PROJETO:DATASET é acme-billing:billing_export.
Se a organização bloqueia contas de fora
Algumas organizações restringem quem pode receber papel no IAM (iam.allowedPolicyMemberDomains, “Domain restricted sharing”). O comando acima falha com a mensagem de que o membro não pertence a um cliente permitido.
Inclua o customer ID C011tigzz como exceção dessa política. A organização é immunoops.io, id 424787708642. Faça a exceção só no projeto do billing, não na organização inteira.
No Google Cloud, abra IAM e administrador › Políticas da organização no projeto do billing.
Abra a restrição Domain restricted sharing (constraints/iam.allowedPolicyMemberDomains).
Adicione C011tigzz aos valores permitidos, sem remover os que já existem.
Salve e rode de novo os dois comandos bq.
Testar
Volte na conta, em Infraestrutura › Contas, e clique em Testar conexão.
O teste lê uma linha da tabela. Sem erro de permissão, a conta fica pendente até chegar custo, ou em dia quando o custo recente aparece.
O que a tela diz
O que fazer
Sem tabela
Informe projeto.dataset.tabela e salve.
A organização bloqueia contas de fora
Inclua o customer ID C011tigzz e teste de novo.
Não foi possível ler o export
Confira se os dois comandos bq rodaram no dataset certo e teste de novo.
!
A última conta ficaEnquanto houver VM ou Cloud Run, a última conta de nuvem não pode ser removida. Enquanto houver Cloud Run, a última conta GCP não pode ser removida. Cadastre a conta que continua valendo e só então remova a outra.
A Visão Geral responde uma pergunta: está tudo bem agora? Os números são os mesmos em todas as telas: um alerta crítico aqui é o mesmo alerta em Alertas e Incidentes.
Faixa de status:Saudável, Atenção ou Crítico, com a frase que explica o porquê.
Números do topo: alertas disparando, clusters conectados, workloads monitorados e o último sinal recebido.
Alertas disparando: cada linha traz o problema e leva à regra em Alertas e Incidentes.
Clusters: a conexão do agent de cada cluster.
app.immunoops.io/ui/
IMMUNO.OPS
Administrar▸
Investigar▸
Analisar▸
Operar▾
Visão Geral
VRVanessa R.⚿
OPERAR / VISÃO GERALPTAAcme ▾✦
Visão Geral do Immuno Ops
Status operacional unificado entre workloads, confiabilidade, custo e plataforma.
Atualizar status
Atenção
2 regras de alerta disparando agora.
Alertas disparando
2
Clusters conectados
3/3
Último heartbeat
12s
Alertas disparando
checkout · latência p95prod-gke · desde 14:02Disparando
billing · erro 5xxprod-gke · desde 14:10Disparando
Operar › Visão Geral · dados ilustrativos
i
Tela vazia?Conecte seu primeiro recurso quer dizer que nenhum cluster, VM ou Cloud Run mandou dado ainda. Volte ao passo 05. Não mostramos número inventado enquanto isso.
Seu cluster tem uma nota, e o Immuno Ops mostra qual é. O FinOps Score vai de 0 a 100 e é calculado com os dados reais do seu cluster, nunca com amostra.
Vá em Analisar › Kubernetes FinOps e escolha o cluster.
Leia o FinOps Score: 100 menos o desperdício ponderado por custo. As barras (Capacidade, Requests, Autoscaling, Storage, Rede e Dono) mostram onde está o desperdício. A mais baixa é onde começar.
Veja o custo de CPU e memória, o desperdício e as opções de rightsizing.
Use Como ler estes dados para saber de onde vem cada número e o que ainda não é coletado.
app.immunoops.io/ui/kubernetes-finops
IMMUNO.OPS
Administrar▸
Investigar▸
Analisar▾
Kubernetes FinOps
FOCUS Normalizer
Operar▸
VRVanessa R.⚿
ANALISAR / KUBERNETES FINOPSPTAAcme ▾✦
Kubernetes FinOps
Capacidade, desperdício e recomendações por cluster.
Mais de uma nuvem?Analisar › FOCUS Normalizer mostra o billing das suas nuvens no mesmo formato (padrão FOCUS), para comparar SKUs lado a lado. O custo da conta GCP entra por aqui depois do export descrito em Conta de nuvem.
Quer ampliar os limites ou precisa de um contrato com SSO e SLA? Fale com o time direto pelo console. Seu uso já vai junto no pedido, então você só conta o que precisa.
Vá em Administrar › Empresa e, no painel Plano, clique em Falar com vendas.
Escolha o assunto: Trocar de plano, Aumentar volume de créditos, Enterprise ou contrato personalizado ou Outra dúvida.
Se quiser, conte mais: por exemplo, quantos clusters você pretende conectar.
Escolha como prefere ser contatado: e-mail (resposta em até 1 dia útil) ou WhatsApp (mais rápido no horário comercial).
Envie. Você recebe um protocolo, e alguém do time técnico responde direto, sem fila de qualificação automática.
app.immunoops.io/ui/company
IMMUNO.OPS
Administrar▾
Clusters
VMs
Cloud Run
Instrumentação
Equipe
Empresa
Investigar▸
Analisar▸
Operar▸
VRVanessa R.⚿
ADMINISTRAR / EMPRESAPTAAcme ▾✦
Empresa
✉
Falar com vendas
Seu plano e seu uso já vão junto. Você só conta o que precisa.
Trocar de planoVer outro plano que caiba melhor no seu uso.
Aumentar volume de créditosMais créditos por mês para o uso da plataforma.
Enterprise ou contrato personalizadoSSO, SLA, volume alto, faturamento anual.
Outra dúvidaQualquer outra coisa sobre plano ou cobrança.
Preciso dar acesso de escrita na minha conta de nuvem?
Não. A conta é somente leitura do billing. No GCP, o papel é BigQuery Data Viewer (roles/bigquery.dataViewer) no dataset do export, para [email protected] e [email protected]. O passo a passo está em Conta de nuvem. Métricas e logs do Cloud Run, e ligar ou desligar VM, usam outros papéis de leitura ou de energia da instância, em Permissões de VM e Cloud Run.
O Cloud Run não mostra métricas ou logs
No projeto do serviço, conceda roles/monitoring.viewer e roles/logging.viewer para [email protected]. Os comandos estão em Cloud Run. Se a tela disser que a coleta de logs ainda não está habilitada para a conta, fale com o suporte: o papel prepara o acesso, e a coleta começa depois dessa liberação.
A política de suspensão não desliga a VM
A conta [email protected] precisa listar, iniciar e parar instâncias no projeto da VM. Os comandos do papel immunoOpsVmPower estão em VM. A VM também precisa do agente instalado e de saída HTTPS para app.immunoops.io para enviar métricas e logs.
A organização bloqueia a conta do Immuno Ops no IAM
A política iam.allowedPolicyMemberDomains está recusando um membro de fora. Inclua o customer ID C011tigzz (organização immunoops.io, id 424787708642) como exceção, de preferência só no projeto do billing, e rode de novo os comandos de leitura.
A conta GCP está “Sem tabela”
Abra a conta, informe a tabela no formato projeto.dataset.tabela e clique em Salvar tabela. Sem essa tabela a conta não entra no billing.
Os números são reais?
Sim. Todo dado vem do seu cluster e da sua conta de nuvem. Quando ainda não há dado, a tela diz isso em vez de mostrar um número inventado.
Problemas comuns
Meu cluster está como “Pendente” há muito tempo
O agent nunca mandou dado. Confira se o comando helm terminou sem erro, se os pods do agent estão Running e se o cluster tem saída de rede para o Immuno Ops.
O cluster está conectado, mas Workloads está vazio
O inventário pode levar alguns minutos para chegar depois da conexão. Se a tela disser “Ainda não recebemos workloads de…”, teste a conexão e confira os logs do agent.
Não recebi o código de verificação no cadastro
Olhe a caixa de spam e espere o contador para usar Reenviar. Confira o e-mail em ← Trocar e-mail.
“Não foi possível criar a conta”
Normalmente sua empresa já tem cadastro. Peça um convite ao administrador da organização.
“Sua conta não tem organização ativa”
Seu acesso foi suspenso ou removido em todas as organizações. Peça a um administrador para reativar ou convidar você de novo.
Não vejo os botões de conectar ou convidar
Seu papel é Leitura. Peça a um administrador para alterar seu papel em Equipe.