Tous les produits
Search
Centre de documentation

:DescribeLogMonitorAttribute

Dernière mise à jour :Aug 08, 2026

Interroge les détails d'une métrique de surveillance des journaux.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

DescribeLogMonitorAttribute

Opération à effectuer. Définissez la valeur sur DescribeLogMonitorAttribute.

MetricName

String

Oui

cpu_total

Nom de la métrique de surveillance des journaux. La correspondance exacte est prise en charge.

Pour plus d'informations, consultez Annexe 1 : Métriques.

Paramètres de réponse

ParamètreTypeExempleDescription
CodeString200

Code d'état HTTP.

Remarque Le code d'état 200 indique que l'appel a réussi.
LogMonitorStructN/A

Détails de la métrique de surveillance des journaux.

AggregatesArray of AggregateN/A

Fonctions d'agrégation.

AliasStringHostName

Alias de la fonction d'agrégation.

FieldNameStringhostName

Nom du champ dans les journaux.

FunctionStringcount

Fonction utilisée pour agréger les données de surveillance des journaux au cours d'une période d'agrégation. Valeurs valides :

  • count : compte le nombre.
  • sum : calcule la valeur totale.
  • avg : calcule la valeur moyenne.
  • max : sélectionne la valeur maximale.
  • min : sélectionne la valeur minimale.
  • countps : divise le nombre compté du champ spécifié par le nombre total de secondes de la période d'agrégation.
  • sumps : divise la valeur totale du champ spécifié par le nombre total de secondes de la période d'agrégation.
  • distinct : compte le nombre de journaux contenant le champ spécifié au cours de la période d'agrégation.
MaxString10

Valeur maximale.

MinString0

Valeur minimale.

GmtCreateLong1547431398000

Heure de création de la métrique de surveillance des journaux.

Cette valeur est un horodatage UNIX représentant le nombre de millisecondes écoulées depuis l'époque, soit le 1er janvier 1970 à 00:00:00 UTC.

GroupIdLong12345

ID du groupe d'applications.

GroupbysListvalue

Dimension selon laquelle les données sont regroupées. Ce paramètre équivaut à la clause GROUP BY dans les instructions SQL. Si aucune dimension n'est spécifiée, toutes les données sont agrégées sur la base de la fonction d'agrégation.

LogIdLong1234

ID renvoyé par Log Service.

MetricExpressString{"extend":{"errorPercent":"5XXNumber/TotalNumber*100"}}

Champ étendu. Le champ étendu permet d'effectuer des opérations de base sur les résultats d'agrégation.

Supposons que vous avez calculé TotalNumber et 5XXNumber en agrégeant les données. TotalNumber indique le nombre total de requêtes HTTP et 5XXNumber indique le nombre de requêtes HTTP dont le code d'état est supérieur à 499. Vous pouvez calculer le taux d'erreur du serveur en ajoutant la formule suivante au champ étendu : 5XXNumber/TotalNumber*100.

MetricNameStringcpu_total

Nom de la métrique de surveillance des journaux. Pour plus d'informations, consultez Annexe 1 : Métriques.

SlsLogstoreStringtest-logstore

Nom du Logstore Log Service.

SlsProjectStringtest-project

Nom du projet Log Service.

SlsRegionIdStringcn-hangzhou

ID de la région où réside le Logstore Log Service.

TumblingwindowsList60

Taille de la fenêtre glissante pour le calcul. Unité : secondes. Le système effectue une agrégation pour chaque fenêtre glissante.

ValueFilterArray of ValueFilterObjectN/A

Condition utilisée pour filtrer les journaux. Les paramètres ValueFilter et ValueFilterRelation sont utilisés conjointement. La condition de filtre équivaut à la clause WHERE dans les instructions SQL.

Si aucune condition de filtre n'est spécifiée, tous les journaux sont traités. Supposons que les journaux contiennent le champ Level, qui peut être défini sur Error. Si vous devez calculer le nombre de fois où les journaux de niveau Error apparaissent chaque minute, vous pouvez définir la condition de filtre sur Level=Error et compter le nombre de journaux qui satisfont à cette condition.

KeyStringhostName

Nom du champ de journal utilisé pour la correspondance dans la condition de filtre.

OperatorStringcontain

Méthode utilisée pour faire correspondre la valeur du champ. Valeurs valides :

  • contain
  • notContain
  • > : supérieur à
  • < : inférieur à
  • >= : supérieur ou égal à
  • <= : inférieur ou égal à
ValueStringportal

Valeur de champ à faire correspondre dans la condition de filtre.

ValueFilterRelationStringand

Opérateur logique utilisé entre les conditions de filtre des journaux. Les paramètres ValueFilter et ValueFilterRelation sont utilisés conjointement. Valeurs valides :

  • and
  • or
MessageStringsuccessful

Message renvoyé. Si l'appel a réussi, la valeur success est renvoyée. Si l'appel a échoué, un message d'erreur est renvoyé.

RequestIdStringC6718537-E673-4A58-8EE1-24B8B38C7AAE

ID de la requête.

SuccessBooleantrue

Indique si l'appel a réussi. Valeurs valides :

  • true : L'appel a réussi.
  • false : L'appel a échoué.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=DescribeLogMonitorAttribute
&MetricName=cpu_total
&<Common request parameters>

Exemples de réponses réussies

XML format

<DescribeLogMonitorAttributeResponse>
          <Message>successful</Message>
          <RequestId>BBD7B294-1325-46D1-BD08-848D6A6B9AC6</RequestId>
          <LogMonitor>
                <SlsProject>slsProject</SlsProject>
                <Tumblingwindows>60</Tumblingwindows>
                <SlsLogstore>slsLogstore</SlsLogstore>
                <MetricExpress>{"extend":{}}</MetricExpress>
                <GroupId>12345</GroupId>
                <MetricName>cpu_total</MetricName>
                <GmtCreate>1577766395000</GmtCreate>
                <Aggregates>
                      <Function>count</Function>
                      <Min></Min>
                      <Max></Max>
                      <Alias>lh_source_count</Alias>
                      <FieldName>lh_source</FieldName>
                </Aggregates>
                <ValueFilterRelation>and</ValueFilterRelation>
                <ValueFilter>
                      <Operator>contais</Operator>
                      <Value>test</Value>
                      <Key>hostName</Key>
                </ValueFilter>
                <LogId>1234</LogId>
                <SlsRegionId>cn-hangzhou</SlsRegionId>
          </LogMonitor>
          <Code>200</Code>
          <Success>true</Success>
</DescribeLogMonitorAttributeResponse>

JSON format

{
  "Message": "successful",
  "RequestId": "BBD7B294-1325-46D1-BD08-848D6A6B9AC6",
  "LogMonitor": {
    "SlsProject": "slsProject",
    "Tumblingwindows": [
      60
    ],
    "SlsLogstore": "slsLogstore",
    "MetricExpress": "{\"extend\":{}}",
    "GroupId": 12345,
    "MetricName": "cpu_total",
    "GmtCreate": 1577766395000,
    "Aggregates": [
      {
        "Function": "count",
        "Min": "",
        "Max": "",
        "Alias": "lh_source_count",
        "FieldName": "lh_source"
      }
    ],
    "Groupbys": [],
    "ValueFilterRelation": "and",
    "ValueFilter": [
      {
        "Operator": "contais",
        "Value": "test",
        "Key": "hostName"
      }
    ],
    "LogId": 1234,
    "SlsRegionId": "cn-hangzhou"
  },
  "Code": 200,
  "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.