Primeiros passos

Ao terminar este guia você vai ter seu primeiro cliente criado, um dispositivo dele reportando no console e os alertas configurados para chegarem até você de verdade.

Leva uns quinze minutos.

Sua conta

Quando você se cadastra, começa com 14 dias de teste gratuito, sem cartão de crédito. Durante esse período você tem os módulos de software padrão habilitados, até 10 dispositivos e 3 técnicos. O SSO corporativo e os serviços contratuais do KairosEnterpriseFlex não fazem parte do teste.

A primeira coisa que você vê não é o console, e sim uma tela pedindo que você confirme seu e-mail. Procure a mensagem e clique no link. Se ela nunca chegou, essa mesma tela tem Reenviar e-mail de verificação.

Quando os 14 dias terminam, o serviço não é cortado. A conta passa para um plano pago, então, se você vai continuar, cadastre sua forma de pagamento em Assinatura.

A ordem

É isso que mais confunde as pessoas no começo, então aqui vai sem rodeios:

Cliente, depois instalador, depois dispositivo.

Você não adiciona dispositivos na mão. Os dispositivos aparecem sozinhos assim que o agente é instalado e se conecta. E o agente é instalado com um instalador gerado a partir de um cliente, então o dispositivo fica atribuído a esse cliente desde o primeiro segundo.

Se você é um MSP com vinte clientes, cada um é um cliente aqui. Se você é o departamento de TI de uma única empresa, crie um cliente com o nome da empresa e pronto.

Passo 1: crie seu primeiro cliente

1. Menu lateral, Clientes.
2. Clique em + Novo cliente.
3. Digite o Nome do cliente. É o único campo realmente obrigatório: o status já vem como Ativo.
4. Criar cliente.

Todo o resto (pessoa de contato, e-mail, telefone, endereço, notas) pode ser preenchido depois. Não trave aqui.

Dois campos que vale a pena entender, mas que podem ficar para depois:

• Idioma do cliente afeta o portal e os e-mails que esse cliente recebe. Não muda o idioma do seu console.
• Banco de horas mensal só importa se você for usar o apontamento de horas. Ele é zerado no dia 1º de cada mês.

Passo 2: instale o agente

Abra o cliente que você acabou de criar e vá até a aba Dispositivos. A seção Instalador fica mais abaixo na página.

São seis caminhos. Escolha pela sua situação:

Para o primeiro dispositivo, vá pelo MSI ou por um dos dois comandos de uma linha.

Windows: o MSI

1. Clique em + Criar instalador.
2. Se quiser, preencha as etiquetas de local, departamento e tipo de dispositivo. O dispositivo vai ficar classificado desde o início.
3. Espere. A geração leva entre 30 e 90 segundos: o instalador é compilado com a credencial do seu cliente dentro dele.
4. Quando estiver pronto, baixe e execute na máquina.

O instalador vale 7 dias e funciona em mais de uma máquina durante esse período. Você não precisa de um por dispositivo.

Se você não está na máquina, use Copiar link. Esse link baixa o instalador sem pedir login, então você pode enviá-lo a alguém do cliente por e-mail ou chat sem dar acesso ao seu console. Ele expira junto com o instalador.

Linux: o comando de uma linha

1. Na caixa de diálogo, vá para a aba Linux.
2. Clique em Copiar comando.
3. Cole no servidor e execute.

É uma única linha que instala e cadastra de uma vez. Não há nada para compilar ou baixar antes.

Requisitos: a máquina precisa usar systemd e ser x86_64. O instalador cobre Ubuntu, Debian, RHEL, Fedora, CentOS, Rocky, AlmaLinux, Oracle Linux, SUSE, openSUSE, Alpine, Amazon Linux e Arch. O Alpine só funciona se estiver configurado com systemd, já que por padrão ele usa OpenRC.

Se você rodar a mesma linha de novo em uma máquina que já tem o agente, ele é atualizado e não duplica o dispositivo no console.

macOS: o comando de uma linha

1. Na caixa de diálogo, vá para a aba macOS.
2. Clique em Copiar comando.
3. Cole no Mac e execute.

Como no Linux, é uma única linha que instala e cadastra de uma vez, e ela não expira. O binário é universal: o mesmo download cobre Apple Silicon e Intel.

O acesso remoto exige um passo a mais no Mac: o usuário do dispositivo precisa conceder três permissões do sistema, e elas não podem ser concedidas remotamente. Isso está no guia Instalar o agente macOS.

Windows em escala: GPO

Se o cliente tem um domínio e você já tem o agente no Domain Controller, dá para implantar em todo o resto de uma vez, sem tocar em nenhuma máquina e sem usar credenciais.

Você precisa de quatro coisas: o módulo de Active Directory (do KairosBusiness), a permissão de implantação de agentes, um Domain Controller online e atribuído a um cliente, e um MSI já gerado para esse cliente.

A instalação acontece na próxima atualização de política, entre 90 minutos e 2 horas, ou antes se a máquina reiniciar. Até 500 dispositivos por campanha.

Este é o único caminho com tela de diagnóstico própria: você vê quantos foram cadastrados do total e o que cada um reportou.

Passo 3: veja o dispositivo no console

O dispositivo aparece online no instante em que o agente se conecta. Não há ciclo nenhum para esperar.

O que chega em etapas são os dados:

Então, se depois de dez minutos o dispositivo aparece online mas sem lista de softwares, está tudo certo. Os dados estão a caminho.

Um dispositivo é marcado como offline depois de 70 segundos sem sinal, e a verificação roda a cada minuto. Na prática, entre 70 segundos e dois minutos.

A primeira coisa a fazer depois

Ative os alertas por e-mail do dispositivo.

Este é o passo que mais gente pula e o que sai mais caro. Um dispositivo recém-instalado é monitorado desde o minuto zero: ele abre alertas no console, registra métricas, detecta quedas. Mas não envia um único e-mail até você ligar essa chave, dispositivo por dispositivo.

Se você pular isso, o monitoramento funciona e você não fica sabendo de nada até abrir o console para olhar.

A chave fica na ficha do dispositivo, na seção de monitoramento.

Depois disso, a ordem que faz sentido:

1. Limites e alertas, em Configurações, seção Monitoramento. Você define as porcentagens de CPU, RAM e disco que devem disparar um aviso, e de quanto em quanto tempo as verificações rodam.
2. Marca, em Configurações. Seu logo e suas cores nos relatórios, nos e-mails e no portal do cliente. É isso que faz seu cliente ver a sua marca, e não a nossa.
3. Usuários e perfis de acesso, para adicionar sua equipe. Lembre que o teste permite até 3 técnicos.
4. Portal do cliente, quando você quiser que seu cliente veja o status dos dispositivos dele e abra chamados sozinho.
5. Notificações do cliente, para definir quais endereços recebem os alertas de cada cliente.

Instalei o agente e o dispositivo não aparece

Verifique nesta ordem:

Você está olhando o cliente certo? O dispositivo aparece no cliente cujo instalador você usou, e em nenhum outro.

Você chegou ao limite de dispositivos? O teste permite 10. O card Dispositivos gerenciados do dashboard mostra a sua contagem. No limite, o cadastro é recusado e o dispositivo nunca aparece.

O instalador expirou? Ele dura 7 dias. Depois disso você precisa gerar um novo.

Você rotacionou a credencial do cliente depois de instalar? Se você rotacionou a credencial de cadastro, os agentes instalados com a anterior não conseguem mais reportar.

Se veio por GPO, abra o detalhe da campanha: ele lista quais máquinas estão faltando e o que cada uma reportou.

Se foi Linux ou macOS, o instalador imprime o motivo da falha no mesmo console onde você colou o comando. Volte e leia essa saída.

Se o dispositivo aparece mas ficou offline, o cadastro funcionou e o que parou foram os sinais de vida. Verifique se o serviço do agente está rodando na máquina.

Perguntas frequentes

Posso adicionar um dispositivo manualmente? Não. Os dispositivos aparecem sozinhos quando o agente se conecta.

Preciso de um instalador por dispositivo? Não. Um cobre todos os dispositivos daquele cliente por 7 dias.

Um instalador funciona para outro cliente? Não. Cada instalador carrega a credencial do seu cliente e cadastra o dispositivo nesse cliente.

Posso mover um dispositivo de um cliente para outro? Sim, pela ficha do dispositivo. Tenha em mente que isso quebra o vínculo com a credencial original, então reinstalar depois com o instalador antigo vai criar um duplicado.

E se eu rodar o instalador duas vezes na mesma máquina? No Linux e no macOS o agente é atualizado e não duplica. No Windows, desinstale antes.

Preciso abrir portas do firewall no cliente? Não. É o agente que inicia a conexão; ele não aceita conexões de entrada.

Quanto dura o teste e o que ele inclui? 14 dias com os módulos de software padrão, até 10 dispositivos e 3 técnicos, sem cartão.

O que acontece no dia 15? O serviço não é cortado. A conta passa para um plano pago. Cadastre sua forma de pagamento em Assinatura se você vai continuar.

Por que o monitoramento não está me enviando e-mails? Porque os alertas por e-mail começam desligados em todo dispositivo. Você precisa ligá-los.

Posso instalar o agente em uma máquina sem internet? No Linux sim, usando o download direto dos quatro arquivos, e no macOS usando o download direto dos arquivos do agente. No Windows a máquina precisa alcançar o console para se cadastrar.