Este guia explica como instalar o agente Stackdriver Logging. O agente coleta registros de vários arquivos comuns e os envia para o Stackdriver Logging. O agente é baseado em `fluentd`. `fluentd` é um coletor de dados de registro de código aberto. O agente Stackdriver Logging é um pacote personalizado do `fluentd`, fornecido pelo Google. Para informações sobre preços, consulte a seção de preços do Stackdriver Logging. ## Antes de começar 1. Você precisa de um projeto do Cloud Platform com o faturamento ativado. Saiba como criar um projeto. [Como criar um projeto](https://cloud.google.com/resource-manager/docs/creating-managing-projects) 2. Você precisa ter um papel do IAM que conceda permissão para gravar os registros no seu projeto. Considere conceder o papel de Gravador de registros ao principal. [Sobre o Identity and Access Management](https://cloud.google.com/iam/docs/) 3. Se você pretende usar o agente em uma instância de máquina virtual (VM) do Compute Engine, configure o acesso à VM. Consulte a seção Como configurar o acesso da VM. ## Como configurar o acesso da VM Para usar o agente Stackdriver Logging em uma instância de VM do Compute Engine, verifique se a VM pode se autenticar no Stackdriver Logging. É possível conceder à sua instância de VM os direitos de acesso necessários ou criar e usar uma conta de serviço. Para mais informações sobre como autenticar o agente, consulte a seção Como autorizar o agente Stackdriver Logging. ### Como usar os direitos de acesso da VM As instâncias de VM do Compute Engine são criadas com um conjunto de direitos de acesso. Para que o agente Stackdriver Logging funcione, você precisa ativar o direito de acesso `logging.write` na sua instância de VM. Quando você usa o console do Google Cloud para criar uma instância de VM do Compute Engine, a ativação do direito de acesso é feita na seção **Identidade e API access**, permitindo o acesso à API Logging. Para mais informações sobre como definir os direitos de acesso da VM, consulte a documentação do Compute Engine em [Como criar uma instância com direitos de acesso de serviço](https://cloud.google.com/compute/docs/access/create-vm-with-access#setting_the_access_scope_for_an_instance). ### Como usar contas de serviço É recomendável usar contas de serviço, mas use os direitos de acesso da VM quando não for possível usar uma conta de serviço. Para usar uma conta de serviço, crie uma e conceda-lhe o papel de Gravador de registros do IAM no seu projeto do Cloud Platform. Em seguida, configure a instância do Compute Engine para ser executada como a conta de serviço. Para mais informações sobre como controlar o acesso usando contas de serviço, consulte a seção Como criar e ativar contas de serviço para instâncias. ## Como instalar o agente O agente Stackdriver Logging é compatível com os seguintes ambientes: * Compute Engine * Amazon Elastic Compute Cloud (Amazon EC2) * Ambientes locais que são executados no Debian e no Ubuntu > O agente pode ser executado em outros ambientes do Linux, mas não há suporte para eles. Se você planeja executar o agente Stackdriver Logging no Amazon EC2, consulte a seção Como instalar no Amazon EC2. Para instalar o agente: * No Compute Engine, o agente é instalado por padrão. * Nos outros ambientes, use o seguinte comando: ```sh curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh sudo bash install-logging-agent.sh ``` Depois de instalar o agente, siga as instruções em Como configurar o agente. ## Como instalar no Amazon EC2 Para instalar o agente Stackdriver Logging em uma instância do Amazon EC2: 1. [Configure o acesso da VM](#vm-access). 2. Conecte-se à sua instância do Amazon EC2 usando SSH. 3. Faça o download do script de instalação e execute-o: ```sh curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh sudo bash install-logging-agent.sh ``` Depois de instalar o agente, siga as instruções em Como configurar o agente. ## Como configurar o agente O agente Stackdriver Logging usa arquivos de configuração para determinar os registros que o agente coleta. Por padrão, o agente Stackdriver Logging é configurado para coletar os seguintes registros: * Todos os registros syslog * Registros do aplicativo `auth.log` * Registros do aplicativo `daemon.log` * Todos os registros gravados em arquivos com a extensão `.log` no diretório `/var/log` O arquivo de configuração do agente está em: * Linux: `/etc/google-cloud-logging/config/logging.conf` Para configurar o agente Stackdriver Logging para coletar registros adicionais, edite o arquivo de configuração. É possível configurar o agente para monitorar vários arquivos de registro, usar vários formatos de registro ou usar vários plug-ins `fluentd`. Para mais informações, consulte a seção Como configurar o agente Logging. ## Como reiniciar o agente Depois de alterar o arquivo de configuração do agente, reinicie o agente usando o seguinte comando. ```sh sudo service google-cloud-logging restart ``` ## Como fazer upgrade do agente Para fazer upgrade do agente, execute o mesmo comando usado para instalar o agente. ```sh curl -sSO https://dl.google.com/cloudagents/install-logging-agent.sh sudo bash install-logging-agent.sh ``` O script de instalação atualiza o agente. ## Como remover o agente Para remover o agente: ```sh sudo apt-get remove google-cloud-logging ``` A remoção do agente não exclui as configurações. Para excluir as configurações, execute o seguinte comando depois de remover o agente: ```sh sudo rm -rf /etc/google-cloud-logging/ ``` ## Código-fonte do agente O código-fonte do agente Stackdriver Logging está disponível no repositório `google-cloud-logging` do GitHub. O agente Stackdriver Logging é licenciado de acordo com a licença Apache 2.0.