Todos os produtos
Search

Este produto

    :PutLogMonitor

    Central de documentação

    :PutLogMonitor

    Última atualização: Jun 26, 2026

    Cria ou modifica uma métrica de monitoramento de log.

    Este tópico exemplifica a criação da métrica de monitoramento de log cpu_total. A resposta confirma a criação da métrica e exibe o ID 16****.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

    Parâmetros da solicitação

    Parâmetro Tipo Obrigatório Exemplo Descrição
    Action String Sim PutLogMonitor

    Operação a ser executada. Defina o valor como PutLogMonitor.

    Aggregates.N.Alias String Sim Count

    Alias da função de agregação. Valores válidos de N: 1 a 10.

    Aggregates.N.FieldName String Sim sourceCount

    Nome do campo a agregar. Valores válidos de N: 1 a 10.

    Aggregates.N.Function String Sim count

    Função usada para agregar dados de monitoramento de logs em um período de agregação. Valores válidos de N: 1 a 10. Valores válidos:

    • count: conta a quantidade.
    • sum: calcula o valor total.
    • avg: calcula a média.
    • max: seleciona o valor máximo.
    • min: seleciona o valor mínimo.
    • countps: divide a contagem do campo especificado pelo total de segundos do período de agregação.
    • sumps: divide o valor total do campo especificado pelo total de segundos do período de agregação.
    • distinct: conta os logs em que o campo especificado aparece durante o período de agregação.
    MetricName String Sim cpu_total

    Nome da métrica. Para mais informações sobre métricas de serviços em nuvem, consulte Apêndice 1: Métricas.

    SlsLogstore String Sim test-logstore

    Nome do Logstore do Log Service.

    SlsProject String Sim test-project

    Nome do projeto do Log Service.

    SlsRegionId String Sim cn-hangzhou

    Região onde reside o projeto do Log Service.

    ValueFilterRelation String Sim and

    Operador lógico entre condições de filtro de log. Valores válidos:

    • and
    • or
    Nota Use os parâmetros ValueFilterRelation e ValueFilter.N.Key em conjunto.
    LogId String Não 16****

    ID da métrica de monitoramento de log.

    GroupId String Não 7301****

    ID do grupo de aplicativos.

    MetricExpress String Não null

    Campo estendido. Permite executar operações básicas nos resultados da agregação.

    Por exemplo, suponha que você tenha calculado TotalNumber e 5XXNumber ao agregar dados. TotalNumber indica o total de solicitações HTTP; 5XXNumber indica aquelas com código de status superior a 499. Calcule a taxa de erro do servidor adicionando a seguinte fórmula ao campo estendido: 5XXNumber/TotalNumber*100.

    Formato JSON: {"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}. Descrição:

    • extend: obrigatório.
    • errorPercent: alias do campo gerado no resultado do cálculo. Especifique o alias conforme necessário.
    • 5XXNumber/TotalNumber*100: expressão de cálculo.
    Groupbys.N.Alias String Não CPUUtilization

    Alias da dimensão de agrupamento dos dados. Valores válidos de N: 1 a 10.

    Groupbys.N.FieldName String Não cpu

    Nome do campo definido como dimensão. Valores válidos de N: 1 a 10.

    ValueFilter.N.Key String Não lh_source

    Nome do campo de log usado para correspondência na condição de filtro. Valores válidos de N: 1 a 10.

    ValueFilter.N.Operator String Não contain

    Método de correspondência do 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
    ValueFilter.N.Value String Não test

    Valor do campo a corresponder na condição de filtro. Valores válidos de N: 1 a 10.

    Tumblingwindows String Não 60.300

    Tamanho da janela deslizante para cálculo. Unidade: segundos. O CloudMonitor agrega dados em cada janela deslizante.

    Unit String Não Percent

    Unidade.

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

    Parâmetros de resposta

    Parâmetro Tipo Exemplo Descrição
    Code String 200

    Código de status HTTP.

    Nota O código 200 indica sucesso na chamada.
    LogId String 16****

    ID da métrica de monitoramento de log.

    Message String successful

    Mensagem retornada.

    • Em caso de sucesso, retorna successful.
    • Em caso de falha, retorna uma mensagem de erro. Exemplo: alias of aggreate must be set value.
    RequestId String 91561287-0802-5F9C-9BDE-404C50D41B06

    ID da solicitação.

    Success Boolean true

    Indica se a chamada teve sucesso. Valores válidos:

    • true: chamada bem-sucedida.
    • false: falha na chamada.

    Exemplos

    Exemplos de solicitações

    http(s)://[Endpoint]/?Action=PutLogMonitor
&Aggregates.1.Alias=Count
&Aggregates.1.FieldName=sourceCount
&Aggregates.1.Function=count
&MetricName=cpu_total
&SlsLogstore=test-logstore
&SlsProject=test-project
&SlsRegionId=cn-hangzhou
&ValueFilterRelation=and
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

    <PutLogMonitorResponse>
	  <Message>successful</Message>
	  <RequestId>91561287-0802-5F9C-9BDE-404C50D41B06</RequestId>
	  <Code>200</Code>
	  <LogId>16****</LogId>
	  <Success>true</Success>
</PutLogMonitorResponse>

    Formato JSON

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

    Códigos de erro

    HttpCode

    Código de erro

    Mensagem de erro

    Descrição

    404

    ResourceNotFound

    The specified resource is not found.

    Mensagem de erro retornada quando o recurso especificado não é encontrado.

    Para obter uma lista de códigos de erro, visite o API Error Center.