Query - Get

Référence

Service:: Log Analytics

Version d'API:: 2022-10-27_Preview

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}

Avec des paramètres facultatifs:

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 à partir 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)	Optionnel. Intervalle de temps sur lequel interroger les données. Il s’agit d’une valeur de période ISO8601. Cet intervalle de temps est appliqué en plus des éléments spécifiés dans l’expression de requête.

Réponses

Nom	Type	Description
200 OK	queryResults	D’ACCORD. 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

HTTP

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

Code d’état:: 200

{
  "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

HTTP

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

Exemple de réponse

Code d’état:: 200

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 pour 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

Object

Colonne de table.

Nom	Type	Description
name	string	Nom de cette colonne.
type	logsColumnType	Type de données de cette colonne.

errorDetail

Object

Détails de l’erreur.

Nom	Type	Description
additionalProperties	object	Propriétés supplémentaires qui peuvent être fournies sur l’objet détails de l’erreur
code	string	Code de l’erreur.
message	string	Message d’erreur lisible par l’homme.
resources	string[]	Indique les ressources qui ont été responsables de l’erreur.
target	string	Indique quelle propriété dans la demande est responsable de l’erreur.
value	string	Indique quelle valeur dans ' target' est responsable de l’erreur.

errorInfo

Object

Code et message pour une erreur.

Nom	Type	Description
additionalProperties	object	Propriétés supplémentaires qui peuvent être fournies sur l’objet d’informations d’erreur
code	string	Code d’erreur lisible par l’ordinateur.
details	errorDetail[]	détails de l’erreur.
innererror	errorInfo	Code et message pour une erreur. Détails de l’erreur interne s’ils existent.
message	string	Message d’erreur lisible par l’homme.

errorResponse

Object

Détails de l’erreur.

Nom	Type	Description
error	errorInfo	Code et message pour une erreur. Détails de l’erreur.

logsColumnType

Énumération

Type de données de cette colonne.

Valeur	Description
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Object

Réponse à une requête.

Nom	Type	Description
error	errorInfo	Code et message pour 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

Object

Données de visualisation au format JSON.

Statistics

Object

Statistiques représentées au format JSON.

table

Object

Table de réponse de requête.

Nom	Type	Description
columns	column[]	Liste des colonnes de ce tableau.
name	string	Nom de la table.
rows	object[]	Lignes résultantes de cette requête.

Partager via

Query - Get

Paramètres URI

Réponses

Sécurité

oauth2

Étendues

Exemples

cross-workspace

Exemple de requête

Exemple de réponse

simple-query

Exemple de requête

Exemple de réponse

Définitions

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table