Simple Log Service:Configurar o SLS CLI

Fontes e prioridade de credenciais

O SLS CLI reutiliza as credenciais do Alibaba Cloud CLI quando disponíveis, eliminando a necessidade de configurar outra conta. Configurar o Alibaba Cloud CLI.

Prioridade de resolução de credenciais (da mais alta para a mais baixa):

Configurar a conta padrão

Por padrão, o SLS CLI usa a conta main. Configure um par de AccessKey e um endpoint para a conta main e conceda permissões para gerenciar projetos.

1. Faça logon no servidor do SLS CLI.

2. Configure as credenciais da conta padrão.

   Execute o seguinte comando:

   aliyunlog configure "AccessKey ID" "AccessKey Secret" Endpoint

   • Substitua AccessKey ID e AccessKey Secret pelas credenciais de uma conta com permissões de SLS. Para obter mais informações, consulte Par de AccessKey e Criar um usuário RAM e conceder permissões.

   • Substitua Endpoint pelo endpoint de um projeto. Use um endpoint público. Para obter mais informações, consulte Endpoint.

3. Verifique a configuração.

   Abra o arquivo de configuração .aliyunlogcli. Se a saída for semelhante ao exemplo abaixo, a conta padrão estará configurada.

   [main]
   access-id = LTAI******pLMZ
   access-key = XjAsP******eRqax
   region-endpoint = cn-hangzhou.log.aliyuncs.com
   sts-token =

   Nota

   Caminho do arquivo .aliyunlogcli por sistema operacional:

   • Linux: ~/.aliyunlogcli

   • Windows: C:\Users\UserName\.aliyunlogcli

   Se a configuração falhar, corrija o erro com base no código de erro retornado.

Configurar várias contas

Para gerenciar dados de log em diferentes contas, configure credenciais e endpoints para cada uma.

1. Faça logon no servidor do SLS CLI.

2. Configure credenciais para contas adicionais.

   Execute o seguinte comando:

   aliyunlog configure "AccessKey ID" "AccessKey Secret" Endpoint Name

   • Substitua AccessKey ID e AccessKey Secret pelas credenciais de uma conta com permissões de SLS. Para obter mais informações, consulte Par de AccessKey e Criar um usuário RAM e conceder permissões.

   • Substitua Endpoint pelo endpoint de um projeto. Use um endpoint público. Para obter mais informações, consulte Endpoint.

   • Substitua Name por um nome de conta personalizado.

3. Verifique a configuração.

   Abra o arquivo de configuração ~/.aliyunlogcli. Se a saída for semelhante ao exemplo abaixo, as contas estarão configuradas.

   [main]
   access-id = LTAI******pLMZ
   access-key = XjAsP******eRqax
   region-endpoint = cn-hangzhou.log.aliyuncs.com
   sts-token =
   
   [test]
   access-id = As******sPzvb
   access-key = FtagJeR******bQqax
   region-endpoint = cn-shanghai.log.aliyuncs.com
   sts-token =

   Nota

   Caminho do arquivo .aliyunlogcli por sistema operacional:

   • Linux: ~/.aliyunlogcli

   • Windows: C:\Users\UserName\.aliyunlogcli

   Se a configuração falhar, corrija o erro com base no código de erro retornado.

   Use --client-name=testName para executar um comando com uma conta específica. Por exemplo, aliyunlog log create_project ..... --client-name=test executa o comando como a conta test.

Formatar saída

O SLS CLI oferece suporte à formatação JSON e ao escape de caracteres na saída.

• Formatar saída JSON

  Por padrão, o SLS CLI gera a saída JSON em uma única linha. Formate a saída usando um destes métodos:

  • Formatar a saída de um comando específico

    Exemplo: aliyunlog log get_log .... --format-output=json formata a saída JSON do comando get_log.

  • Formatar a saída de todos os comandos

    Execute aliyunlog configure --format-output=json para formatar globalmente a saída de todos os comandos.

• Escape de caracteres

  Por padrão, caracteres não ingleses na saída são escapados. Para exibir os caracteres originais, defina --format-output como no_escape.

  Execute aliyunlog configure --format-output=no_escape para desativar o escape globalmente.

Escapar caracteres especiais

Consultas que contêm cifrões ($), acentos graves (`), barras invertidas (\) ou pontos de exclamação (!) podem falhar ou retornar resultados incorretos.