PutLogMonitor - Cloud Monitor: Central de Documentação do Alibaba Cloud

Cria ou modifica uma métrica de monitoramento de log chamando a operação PutLogMonitor.

Descrição da operação

Este tópico fornece um exemplo de como criar uma métrica de monitoramento de log chamada cpu_total. A resposta mostra que a métrica de monitoramento de log foi criada. O ID da métrica de monitoramento de log é 16****.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cms:PutLogMonitor

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
LogId	string	Não	O ID da métrica de monitoramento de log.	16****
SlsRegionId	string	Sim	A região onde o projeto do Log Service reside.	cn-hangzhou
SlsProject	string	Sim	O nome do projeto do Log Service.	test-project
SlsLogstore	string	Sim	O nome do Logstore do Log Service.	test-logstore
MetricName	string	Sim	O nome da métrica. Para informações sobre as métricas suportadas pelo CloudMonitor para serviços da Alibaba Cloud, consulte Métricas de monitoramento de serviços em nuvem.	cpu_total
MetricExpress	string	Não	O campo estendido. O campo estendido fornece operações aritméticas nos resultados dos métodos estatísticos. Por exemplo, se você configurar o número total de solicitações de código de status HTTP (TotalNumber) e o número de solicitações com códigos de status HTTP maiores que 499 (5xxNumber) nos métodos estatísticos, poderá usar o campo estendido para calcular a taxa de erro do servidor: 5xxNumber/TotalNumber×100. Formato JSON: {"extend":{"errorPercent":"5xxNumber/TotalNumber*100"}}. Descrição dos campos: extend: obrigatório. errorPercent: o alias do novo campo gerado a partir do resultado do cálculo. Você pode especificar um nome personalizado. errorPercent: a expressão de cálculo para campos existentes.	{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}
GroupId	string	Não	O ID do grupo de aplicações.	7301****
ValueFilterRelation	string	Sim	O operador lógico usado para combinar condições de filtro de log. Valores válidos: and or Nota Este parâmetro deve ser usado em conjunto com `ValueFilter.N.Key`.	and
Tumblingwindows	string	Não	O tamanho da janela de tumbling para pré-agregação. Unidade: segundos. O CloudMonitor realiza um cálculo de agregação nos dados no intervalo especificado.	60,300
Unit	string	Não	A unidade.	Percent
Aggregates	array<object>	Sim	As definições de funções de agregação.
	object	Não
FieldName	string	Sim	O nome do campo original para agregação. Valores válidos de N: 1 a 10.	sourceCount
Function	string	Sim	O método estatístico usado para agregar dados de log dentro de um período estatístico. Valores válidos de N: 1 a 10. Valores válidos: count: conta o número de ocorrências. sum: calcula a soma. avg: calcula a média. max: retorna o valor máximo. min: retorna o valor mínimo. countps: calcula a contagem média por segundo para o campo especificado dentro do período estatístico. sumps: calcula a soma média por segundo para o campo especificado dentro do período estatístico. distinct: conta o número de ocorrências do campo especificado após deduplicação dentro do período estatístico.	count
Alias	string	Sim	O alias da função de agregação. Valores válidos de N: 1 a 10.	Count
Groupbys	array<object>	Não	As dimensões usadas para agregação espacial. Isso é equivalente à cláusula Group By em SQL, que agrupa dados de monitoramento por dimensões especificadas. Se nenhuma dimensão for especificada, todos os dados de monitoramento serão agregados com base na função de agregação.
	object	Não
FieldName	string	Não	O nome do campo Group By. Valores válidos de N: 1 a 10.	cpu
Alias	string	Não	O alias do campo Group By. Valores válidos de N: 1 a 10.	CPUUtilization
ValueFilter	array<object>	Não	As regras de filtro, usadas em conjunto com ValueFilterRelation. Isso é equivalente à cláusula Where em SQL. Se este parâmetro não for especificado, todos os dados serão processados. Por exemplo, se o log contiver os campos Level e Error e você quiser contar o número de ocorrências de Error por minuto, poderá definir o método estatístico para somar o campo Level com a condição Level=Error.
	object	Não
Key	string	Não	O nome do campo de log a ser correspondido. Valores válidos de N: 1 a 10.	lh_source
Value	string	Não	O valor do campo de log a ser correspondido. Valores válidos de N: 1 a 10.	test
Operator	string	Não	O método de correspondência para o valor do campo. Valores válidos de N: 1 a 10. Valores válidos: `contain`: contém. `notContain`: não contém. `>`: maior que. `<`: menor que. `>=`: maior ou igual a. `<=`: menor ou igual a.	contain

Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
Code	string	O código de status HTTP. Nota 200 indica sucesso.	200
Message	string	A mensagem retornada. Resultados: Se a operação for bem-sucedida, `successful` é retornado. Se a operação falhar, uma mensagem de erro é retornada, como `alias of aggreate must be set value.`.	successful
RequestId	string	O ID da solicitação.	91561287-0802-5F9C-9BDE-404C50D41B06
LogId	string	O ID da métrica de monitoramento de log.	16****
Success	boolean	Indica se a operação foi bem-sucedida. Valores válidos: true: a operação foi bem-sucedida. false: a operação falhou.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "91561287-0802-5F9C-9BDE-404C50D41B06",
  "LogId": "16****",
  "Success": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	ParameterInvalid	%s
400	LimitorError	Log monitor limit is not enough
500	InternalError	The request processing has failed due to some unknown error.
403	AccessForbidden	User not authorized to operate on the specified resource.
404	ResourceNotFound	The specified resource is not found.	The specified resource is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.