# Guia Gerenciamento do Environment Center da Elven Platform O **Environments Center** da **Elven Platform** é o coração da gestão de sua infraestrutura em nuvem. Ele oferece uma interface intuitiva para criar e gerenciar Environments, que são reflexos de ambientes reais nos provedores de nuvem, conectados por meio de configurações e agentes. Com um Environment, você pode monitorar e visualizar insights de recursos de forma centralizada, garantindo maior controle e organização da sua infraestrutura. No entanto, a flexibilidade é uma prioridade na **Elven Platform**: a criação de um Environment não é obrigatória. Se você preferir, pode monitorar recursos específicos diretamente, sem precisar projetar um ambiente completo na plataforma. Essa abordagem garante liberdade para personalizar o monitoramento de acordo com as suas necessidades, sem perder a essência de uma experiência simples e eficiente. **Veja o exemplo:** {% embed url="" %} ## **Acessando o Environment Center** * Navegue até o menu principal e clique em **Monitoring.** * No submenu, selecione item **Environments**. ## **Trabalhando com Environment Center** No **Environments Center** do módulo **Monitoring** da **Elven Platform**, temos uma visão clara e organizada de todos os ambientes configurados. Aqui, você pode criar novos ambientes personalizados, gerenciar informações sobre nuvens conectadas (como AWS, Azure e outras), e editar ou excluir ambientes existentes de forma rápida e prática. Tudo isso com uma abordagem que prioriza a simplicidade e eficiência. Cada detalhe foi pensado para tornar a experiência de gerenciamento mais ágil. Com poucos cliques, é possível configurar novos Environments para refletir seus ambientes na nuvem ou ajustar os existentes com facilidade. Quer criar um ambiente? O botão **‘New’** está à sua disposição, redirecionando você para um formulário intuitivo. E se precisar editar ou remover configurações, ícones de lápis e lixeira garantem uma navegação fluida e sem complicações. Assim, você tem o controle total sobre sua infraestrutura, com a praticidade que só a **Elven Platform** oferece. Ao criar um novo Environment no **Environments Center** da **Elven Platform**, tudo foi projetado para ser intuitivo e direto. No formulário de criação de um Environment, você pode dar um nome único e descritivo ao seu ambiente (como *aws-demo-ambiente*), selecionar o provedor de nuvem que está utilizando, e escolher a região ideal para sua infraestrutura, como *us-east-1*. Tudo para que seu Environment reflita exatamente o que você precisa. Além disso, configure o tipo de instância que melhor atende suas necessidades computacionais(o agente é bem leve, mas a escolha deve refletir a carga computacional que este deverá atender), defina sua VPC e Subnet, e adicione etiqueta (Tag) que facilite a organização e identificação do agente no Provedor de Cloud. Quando tudo estiver pronto, é só clicar em **Save** para finalizar. ## **Agente (Agent)** Em um mundo tecnológico onde a eficiência é essencial, os agentes são protagonistas na coleta e transmissão de dados vitais para o monitoramento e a manutenção de sistemas. Eles geram informações que vão além dos números, revelando histórias por trás das operações bem-sucedidas, falhas e eventos registrados. Aqui iremos explora os principais tipos de tráfego gerado pelos agentes da ElvenWorks — **Hits**, **Failures** e **Logs** — e como esses dados são essenciais para a identificação e resolução de incidentes. Os **Hits** refletem interações bem-sucedidas entre o agente e o ambiente, indicando que tudo está funcionando como esperado. Já as **Failures** destacam pontos de atenção, evidenciando anomalias ou interações malsucedidas. Os **Logs**, por sua vez, são o registro detalhado de eventos, operações e informações cruciais, trazendo clareza para a investigação de qualquer problema. Nos logs do agente da ElvenWorks, cada detalhe importa. Eles apresentam informações como o **ID do agente**, o **ID da aplicação** e do **addon** associados, e até mesmo o **ID do incidente** aberto. Além disso, identificam a organização envolvida (**org\_uid**), registram o tipo de interação (**resolved** ou **alarmed**) e fornecem dados de criação e atualização do incidente. Outros detalhes, como a origem do monitoramento (**origin\_entity**) e a **versão do agente**, ajudam a contextualizar os eventos e entender a sequência que levou a uma situação indesejada. Para garantir relevância e eficiência na análise, essas informações são armazenadas por 15 dias, tempo suficiente para ações proativas e reativas no ambiente. Assim, os agentes não apenas monitoram, mas também narram, em detalhes, o estado e a saúde do sistema, transformando dados em insights e contribuindo para operações mais seguras e estáveis. ## **Trabalhando com Environment e Agent Custom (SO)** A instalação do agente da ElvenWorks é simples e adaptada aos principais sistemas operacionais de servidores, como **Amazon Linux**, **CentOS 7 e 8** e **Ubuntu**. Após escolher o sistema operacional, a plataforma exibirá um código personalizado para facilitar a instalação na sua cloud customizada. Certifique-se de que o **GitHub** já está instalado no servidor antes de prosseguir. **Veja o exemplo:** {% embed url="" %}
Com o código gerado em mãos, basta copiá-lo e colá-lo no terminal do sistema escolhido. O processo é automatizado e rápido. Assim que a instalação for concluída, você estará pronto para continuar a configuração do monitoramento e aproveitar todo o poder de insights do agente ElvenWorks. ### **Como atualizar o agent custom** ``` sudo su - cd agent-custom ./setup.sh --update ``` ## **Trabalhando com Environment e Agent Custom (Kubernetes)** Ao instalar o agente da ElvenWorks no **Kubernetes**, você pode escolher entre duas opções de atualização: **Auto update**, que mantém o agente sempre atualizado automaticamente, ou **Manual update**, onde você controla quando as atualizações são aplicadas. Essa flexibilidade garante que o processo se adapte à sua estratégia de gerenciamento de versões.
Após selecionar a opção desejada, a plataforma exibirá um **YAML configurado automaticamente**. Copie o conteúdo, aplique no seu cluster Kubernetes utilizando o comando **kubectl apply -f**, e o agente será instalado em poucos minutos. Assim que a instalação for finalizada, você poderá prosseguir com a configuração do monitoramento, aproveitando toda a eficiência e os insights fornecidos pelo agente. **Veja o exemplo:** {% embed url="" %} ## **Glossário de Termos Técnicos** **Environment Center**: Área centralizada dentro da **Elven Platform** para gerenciamento e criação de ambientes (Environments). O **Environment Center** permite monitorar, visualizar e gerenciar recursos da infraestrutura conectada aos provedores de nuvem, como AWS, Azure e outros, através de configurações e agentes. **Environments**: Ambientes criados dentro do **Environment Center** para representar infraestruturas reais nos provedores de nuvem. Cada **Environment** ajuda a organizar e monitorar os recursos de maneira centralizada. **Provedores de Nuvem**: Plataformas de nuvem externas que fornecem recursos computacionais, como AWS (Amazon Web Services), Azure, e outros. O **Environment Center** da **Elven Platform** pode ser configurado para se conectar a esses provedores e monitorar os recursos. **Monitoramento de Recursos**: Ação de coletar, visualizar e analisar dados sobre a infraestrutura de nuvem conectada. Com o **Environment Center**, é possível monitorar recursos de forma centralizada e obter insights importantes para a gestão. **Criar um Environment**: Processo de configurar um novo ambiente dentro do **Environment Center**, incluindo a escolha de nome, provedor de nuvem, região, tipo de instância, VPC, Subnet, e outras configurações. Ao criar um ambiente, você reflete a infraestrutura que deseja gerenciar na plataforma. **Nome do Environment**: Campo onde você define um nome único e descritivo para o seu ambiente. O nome deve refletir o propósito do ambiente, facilitando sua identificação. **Provedor de Nuvem**: Serviço de nuvem com o qual o **Environment** será conectado. Exemplos incluem AWS, Azure, entre outros. **Região**: Localização geográfica do provedor de nuvem onde os recursos serão alocados. Cada provedor de nuvem oferece várias regiões para escolher, como us-east-1, eu-west-1, etc. **Tipo de Instância**: Configuração do recurso computacional a ser utilizado no **Environment**. A escolha do tipo de instância deve considerar a carga computacional necessária para atender ao ambiente de forma eficiente. **Agente**: Software que monitora e gerencia os recursos dentro de um **Environment**. O agente é leve, mas sua configuração deve ser ajustada de acordo com a carga computacional que o ambiente exigirá. **VPC (Virtual Private Cloud)**: Rede virtual privada configurada dentro de um provedor de nuvem. No **Environment Center**, você deve selecionar a VPC para o ambiente, permitindo que os recursos sejam isolados dentro da nuvem. **Subnet**: Subdivisão de uma VPC que define um intervalo de endereços IP. Dentro do **Environment Center**, você seleciona a Subnet onde os recursos do ambiente estarão alocados. **Etiqueta (Tag)**: Identificador adicional utilizado para organizar e classificar recursos dentro de um provedor de nuvem. As tags ajudam a identificar facilmente o agente e outros componentes dentro da nuvem. **Hits:** Interações bem-sucedidas entre o agente e o ambiente monitorado, indicando o funcionamento esperado dos sistemas. **Failures:** Interações malsucedidas ou anomalias detectadas pelo agente, que servem como alerta para possíveis problemas. \ \ **Logs:** Registros detalhados de eventos, operações e informações cruciais, utilizados para investigar e solucionar incidentes. \ \ **ID do Agente:** Número único que identifica cada agente instalado em um ambiente. **Application ID (ID da Aplicação):** Número identificador da aplicação onde o agente realizou uma interação. \ \ **Addon ID (ID do Addon):** Número identificador da dependência associada à aplicação monitorada. \ \ **Incident ID (ID do Incidente):** Número que identifica um incidente aberto pelo agente durante a operação. \ \ **Org UID:** Identificador único da organização onde o agente está instalado. **Created At:** Data em que o incidente foi criado pelo agente. **Updated At:** Data da última atualização no incidente registrado. **Origin Entity:** Origem do monitoramento realizado pelo agente, como interna, externa, multiflow ou synthetic. **Type (Tipo):** Classificação da interação registrada pelo agente, podendo ser “resolved” (resolvido) ou “alarmed” (em alerta). **Version (Versão):** Versão do agente instalado no ambiente. **Auto Update:** Opção de atualização automática do agente no Kubernetes, garantindo que ele esteja sempre na versão mais recente. **Manual Update:** Opção de atualização manual do agente no Kubernetes, permitindo maior controle sobre quando as atualizações são aplicadas. **YAML:** Formato de arquivo utilizado para descrever a configuração e as instruções de deploy do agente em clusters Kubernetes. **kubectl apply -f:** Comando utilizado no Kubernetes para aplicar configurações descritas em arquivos YAML. **Amazon Linux:** Sistema operacional baseado em Linux otimizado para rodar em instâncias da AWS. **CentOS:** Distribuição Linux amplamente usada em servidores, disponível nas versões 7 e 8. **Ubuntu:** Sistema operacional baseado em Linux, amplamente utilizado em servidores e ambientes de desenvolvimento. **GitHub:** Plataforma de hospedagem de código-fonte, cuja instalação é um pré-requisito para a instalação do agente em sistemas operacionais. **Cluster Kubernetes:** Conjunto de máquinas que executam contêineres, gerenciados pelo Kubernetes, onde o agente pode ser instalado para monitoramento. ##