Usando ações no IBM Cloud Logs para integrar com serviços de terceiros

Em IBM Cloud Logs, você pode acionar serviços de terceiros com base em seus resultados e valores de pesquisa e enviar dados a esses serviços. Você pode criar ações de gerenciamento a partir de exibições e painéis.

Criando uma ação

Para criar uma ação:

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Na visualização Logs, clicar no ícone Configurações Configurações Esse ícone de configurações não é igual ao ícone na navegação esquerda. O ícone de configurações pode ser localizado na visualização de logs no canto superior direito da página.

  3. Clique em Gerenciar Ações..

  4. Clique em Incluir nova ação.

  5. Para Ação sem título, especifique um nome para sua ação..

  6. Em URL TEMPLATE, digite o endereço URL para o serviço externo. Por exemplo, https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}. Somente http:// e https:// são compatíveis.

    Sintaxe JavaScript é suportada. Por exemplo, é possível especificar condições como {{ condition ? "true value" : "false value" }}. A maioria das funções de JavaScript é suportada

    Você pode incluir variáveis para transmitir dados no site URL. Se digitar chaves duplas ({{}}), uma lista de variáveis disponíveis será exibida.

  7. Selecione o tipo de dados associado à ação.. A ação é exibida no contexto selecionado..

  8. Clique em Avançado para acessar as configurações opcionais

  9. Para tornar a ação pública, alterne Tornar pública quando for salva

  10. Para limitar a ação para Aplicativos ou Subsistemas específicos, selecione os valores na lista

  11. Clique em Salvar Ação

Editando uma ação

Para editar uma ação existente:

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Na visualização Logs, clicar no ícone Configurações Configurações Esse ícone de configurações não é igual ao ícone na navegação esquerda. O ícone de configurações pode ser localizado na visualização de logs no canto superior direito da página.

  3. Na lista de ações, clique na ação para alterar.

  4. Faça as alterações.

  5. Clique em Salvar Ação para salvar suas alterações ou em Reconfigurar para reverter a ação para a última versão salva da ação

Clonando uma ação

Se você desejar criar uma nova ação com base em uma ação existente, será possível clonar uma ação

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Na visualização Logs, clicar no ícone Configurações Configurações Esse ícone de configurações não é igual ao ícone na navegação esquerda. O ícone de configurações pode ser localizado na visualização de logs no canto superior direito da página.

  3. Na lista de ações, passe o mouse sobre a ação que você deseja clonar

  4. Clique no ícone Clone. Uma duplicata de sua ação é criada

  5. Editar a ação clonada e faça suas mudanças.

  6. Clique em Save Action (Salvar ação ) para salvar suas alterações.

Exibindo e Ocultando Ações no Menu Ações

É possível configurar se as ações podem ser acionadas pelos usuários

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Na visualização Logs, clicar no ícone Configurações Configurações Esse ícone de configurações não é igual ao ícone na navegação esquerda. O ícone de configurações pode ser localizado na visualização de logs no canto superior direito da página.

  3. Na lista de ações, clique na ação que você deseja configurar.

  4. Clique no ícone Ocultar do menu Ações para não ter a ação incluída para os usuários no menu Ações. Clique no ícone Mostrar no menu Ações para ter a ação incluída no menu Ações.

Acionando uma ação

Acione uma ação executando as seguintes etapas:

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Clique nos dados exibidos na visualização Um menu é exibido.

  3. Passe o mouse sobre as ações A lista de ações disponíveis é exibida.

  4. Clique na ação para acionar a ação.

    Apenas as ações configuradas para serem exibidas no menu Ações são listadas no menu Ações.

Excluindo uma ação

  1. Na navegação à esquerda, clique no Explorar logs ícone Ícone Explorar Logs > Logs

  2. Na visualização Logs, clicar no ícone Configurações Configurações Esse ícone de configurações não é igual ao ícone na navegação esquerda. O ícone de configurações pode ser localizado na visualização de logs no canto superior direito da página.

  3. Na lista de ações, clique na ação que você deseja excluir.

  4. Clique em Excluir.

    A exclusão é feita imediatamente Não é solicitado que você confirme se deseja que a ação seja excluída

Variáveis que podem ser incluídas em uma ação

Você pode especificar variáveis em um modelo URL para transmitir informações ao seu serviço externo.

As seguintes variáveis são suportadas:

$m.<metadata>
As variáveis de metadados estão disponíveis nos registros. Por exemplo, $m.applicationName ou $m.timestamp.
$d.<key>.<subkey>
Dados disponíveis no log. Por exemplo, $d.kubernetes.labels.my_label.
$p.start_time
O início do intervalo de tempo selecionado como um registro de data e hora da época Unix, em milissegundos.
$p.end_time
O fim do intervalo de tempo selecionado como um carimbo de data/hora da época Unix, em milissegundos.
$p.selected_value
O valor selecionado pelo usuário na UI. Se ativado clicando em uma chave, todo o valor da chave será incluído.

Ação de exemplo

A ação a seguir gera um problema do Jira

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}