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

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

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

Ressources supplémentaires