Partager via


Query - Get

Exécuter une requête Analytics
Exécute une requête Analytics pour les données

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}
GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}&timespan={timespan}

Paramètres URI

Nom Dans Obligatoire Type Description
workspaceId
path True

string

ID de l’espace de travail. Il s’agit de l’ID d’espace de travail du panneau Propriétés dans le Portail Azure.

query
query True

string

Requête Analytics. En savoir plus sur la syntaxe de requête Analytics

timespan
query

string

duration

facultatif. Intervalle de temps sur lequel interroger les données. Il s’agit d’une valeur de période ISO8601. Ce délai est appliqué en plus de ceux spécifiés dans l’expression de requête.

Réponses

Nom Type Description
200 OK

queryResults

OK. L’appel d’API a réussi et le résultat de la requête Analytics se trouve dans la charge utile de réponse

Other Status Codes

errorResponse

Objet de réponse d’erreur.

Sécurité

oauth2

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

cross-workspace
simple-query

cross-workspace

Exemple de requête

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId

Exemple de réponse

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "Type",
          "type": "string"
        },
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "Usage",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "Usage",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "BillingFact",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "BillingFact",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "Operation",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "7"
        ],
        [
          "Operation",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "5"
        ]
      ]
    }
  ]
}

simple-query

Exemple de requête

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=Usage | take 10&timespan=PT12H

Exemple de réponse

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "Computer",
          "type": "string"
        },
        {
          "name": "TimeGenerated",
          "type": "datetime"
        },
        {
          "name": "SourceSystem",
          "type": "string"
        },
        {
          "name": "StartTime",
          "type": "datetime"
        },
        {
          "name": "EndTime",
          "type": "datetime"
        },
        {
          "name": "ResourceUri",
          "type": "string"
        },
        {
          "name": "LinkedResourceUri",
          "type": "string"
        },
        {
          "name": "DataType",
          "type": "string"
        },
        {
          "name": "Solution",
          "type": "string"
        },
        {
          "name": "BatchesWithinSla",
          "type": "long"
        },
        {
          "name": "BatchesOutsideSla",
          "type": "long"
        },
        {
          "name": "BatchesCapped",
          "type": "long"
        },
        {
          "name": "TotalBatches",
          "type": "long"
        },
        {
          "name": "AvgLatencyInSeconds",
          "type": "real"
        },
        {
          "name": "Quantity",
          "type": "real"
        },
        {
          "name": "QuantityUnit",
          "type": "string"
        },
        {
          "name": "IsBillable",
          "type": "bool"
        },
        {
          "name": "MeterId",
          "type": "string"
        },
        {
          "name": "LinkedMeterId",
          "type": "string"
        },
        {
          "name": "Type",
          "type": "string"
        }
      ],
      "rows": [
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "ContosoSQLSrv1",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.286",
          "0.076408",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ],
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "Store010Web3",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.7",
          "0.106767",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ]
      ]
    }
  ]
}

Définitions

Nom Description
column

Colonne de table.

errorDetail

Détails de l’erreur.

errorInfo

Code et message d’une erreur.

errorResponse

Détails de l’erreur.

logsColumnType

Type de données de cette colonne.

queryResults

Réponse à une requête.

Render

Données de visualisation au format JSON.

Statistics

Statistiques représentées au format JSON.

table

Table de réponse de requête.

column

Colonne de table.

Nom Type Description
name

string

Nom de cette colonne.

type

logsColumnType

Type de données de cette colonne.

errorDetail

Détails de l’erreur.

Nom Type Description
additionalProperties

object

Propriétés supplémentaires pouvant être fournies sur l’objet détails de l’erreur

code

string

Code de l’erreur.

message

string

Message d’erreur lisible par l’utilisateur.

resources

string[]

Indique les ressources responsables de l’erreur.

target

string

Indique quelle propriété dans la requête est responsable de l’erreur.

value

string

Indique la valeur dans « target » qui est responsable de l’erreur.

errorInfo

Code et message d’une erreur.

Nom Type Description
additionalProperties

object

Propriétés supplémentaires pouvant être fournies sur l’objet d’informations d’erreur

code

string

Code d’erreur lisible par la machine.

details

errorDetail[]

détails de l’erreur.

innererror

errorInfo

Code et message d’une erreur.
Détails de l’erreur interne s’ils existent.

message

string

Message d’erreur lisible par l’utilisateur.

errorResponse

Détails de l’erreur.

Nom Type Description
error

errorInfo

Code et message d’une erreur.
Détails de l’erreur.

logsColumnType

Type de données de cette colonne.

Nom Type Description
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

queryResults

Réponse à une requête.

Nom Type Description
error

errorInfo

Code et message d’une erreur.

render

Render

Données de visualisation au format JSON.

statistics

Statistics

Statistiques représentées au format JSON.

tables

table[]

Liste des tables, colonnes et lignes.

Render

Données de visualisation au format JSON.

Statistics

Statistiques représentées au format JSON.

table

Table de réponse de requête.

Nom Type Description
columns

column[]

Liste des colonnes de cette table.

name

string

Nom de la table.

rows

object[]

Lignes résultantes de cette requête.