Nesta página, apresentamos os primeiros passos para usar as bibliotecas de cliente do Cloud para a API Stackdriver Error Reporting. Leia mais sobre as bibliotecas de cliente das APIs do Cloud, incluindo as bibliotecas de cliente mais antigas das APIs do Google, em Explicações sobre bibliotecas de cliente.
Como instalar a biblioteca de cliente
C#
Para mais informações, consulte Como configurar um ambiente de desenvolvimento em C#.Install-Package Google.Cloud.ErrorReporting.V1Beta1 -pre
Go
go get -u cloud.google.com/go/errorreporting
Java
Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Java.Se você estiver usando o Maven,
adicione o código abaixo ao arquivo pom.xml
. Para mais informações sobre
BOMs, consulte BOM das bibliotecas do Google Cloud Platform.
Se você estiver usando o Gradle, adicione isto às dependências:
Se você estiver usando o sbt, adicione o seguinte às suas dependências:
Caso você esteja usando o IntelliJ ou o Eclipse, poderá adicionar bibliotecas de cliente ao seu projeto usando estes plug-ins de ambiente de desenvolvimento integrado:
Os plug-ins também oferecem outras funcionalidades, como gerenciamento de chaves de contas de serviço. Consulte a documentação de cada plug-in para mais detalhes.
Node.js
Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Node.js.npm install --save @google-cloud/error-reporting
PHP
composer require google/cloud-error-reporting
Python
Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Python.pip install --upgrade google-cloud-error_reporting
Ruby
Para mais informações, consulte Como configurar um ambiente de desenvolvimento em Ruby.gem install google-cloud-error_reporting
Como configurar a autenticação
Para executar a biblioteca de cliente, você precisa primeiro configurar a autenticação. Para isso, crie uma conta de serviço e defina uma variável de ambiente. Conclua os passos a seguir para configurar a autenticação. Para mais informações, consulte a documentação de autenticação do GCP.
Console do Cloud
Crie uma conta de serviço:
-
No Console do Cloud, acesse a página Criar conta de serviço.
Acesse Criar conta de serviço - Selecione um projeto.
-
No campo Nome da conta de serviço, insira um nome. O Console do Cloud preenche o campo ID da conta de serviço com base nesse nome.
No campo Descrição da conta de serviço, insira uma descrição. Por exemplo,
Service account for quickstart
. - Clique em Criar.
-
Clique no campo Selecionar um papel.
Em Acesso rápido, clique em Básico e em Proprietário.
- Clique em Continuar.
-
Clique em Concluído para terminar a criação da conta de serviço.
Não feche a janela do navegador. Você vai usá-lo na próxima etapa.
Crie uma chave de conta de serviço:
- No Console do Cloud, clique no endereço de e-mail da conta de serviço que você criou.
- Clique em Chaves.
- Clique em Adicionar chave e em Criar nova chave.
- Clique em Criar. O download de um arquivo de chave JSON é feito no seu computador.
- Clique em Fechar.
Linha de comando
É possível executar os seguintes comandos usando o SDK do Cloud na máquina local ou no Cloud Shell.
-
Crie a conta de serviço. Substitua NAME por um nome para a conta de serviço.
gcloud iam service-accounts create NAME
-
Conceda permissões à conta de serviço. Substitua PROJECT_ID pelo ID do seu projeto.
gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:NAME@PROJECT_ID.iam.gserviceaccount.com" --role="roles/owner"
-
Gere o arquivo de chave. Substitua FILE_NAME pelo nome do arquivo de chave.
gcloud iam service-accounts keys create FILE_NAME.json --iam-account=NAME@PROJECT_ID.iam.gserviceaccount.com
Forneça credenciais de autenticação ao código do aplicativo
definindo a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS
.
Substitua [PATH] pelo caminho do arquivo JSON que contém sua
chave da conta de serviço. Essa variável só se aplica à sessão de shell atual.
Assim, se você abrir uma nova sessão, precisará definir a variável novamente.
Linux ou macOS
export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
Exemplo:
export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/my-key.json"
Windows
Com o PowerShell:
$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"
Exemplo:
$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\my-key.json"
Com prompt de comando:
set GOOGLE_APPLICATION_CREDENTIALS=[PATH]
Como usar a biblioteca de cliente
O exemplo a seguir mostra como usar a biblioteca de cliente.
C#
Go
Java
Node.js
PHP
Python
Ruby