Diagnostic - List By Service
Répertorie tous les diagnostics de l’instance de service de gestion des API.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics?api-version=2021-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/diagnostics?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2021-08-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources. |
service
|
path | True |
string |
Nom du service Gestion des API. Modèle d’expression régulière: |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service. |
api-version
|
query | True |
string |
Version de l’API à utiliser avec la demande cliente. |
$filter
|
query |
string |
| Champ | Utilisation | Opérateurs pris en charge | Fonctions prises en charge | |
|
$skip
|
query |
integer int32 |
Nombre d'enregistrements à ignorer. |
|
$top
|
query |
integer int32 |
Nombre d’enregistrements à renvoyer. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Réponse de résultat paginée de diagnostics. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
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
ApiManagementListDiagnostics
Exemple de requête
Exemple de réponse
{
"value": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/applicationinsights",
"type": "Microsoft.ApiManagement/service/diagnostics",
"name": "applicationinsights",
"properties": {
"alwaysLog": "allErrors",
"httpCorrelationProtocol": "Legacy",
"verbosity": "information",
"logClientIp": true,
"loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
"sampling": {
"samplingType": "fixed",
"percentage": 100
},
"frontend": {
"request": {
"headers": [],
"body": {
"bytes": 0
}
},
"response": {
"headers": [],
"body": {
"bytes": 0
}
}
},
"backend": {
"request": {
"headers": [],
"body": {
"bytes": 0
}
},
"response": {
"headers": [],
"body": {
"bytes": 0
}
}
}
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/diagnostics/azuremonitor",
"type": "Microsoft.ApiManagement/service/diagnostics",
"name": "azuremonitor",
"properties": {
"logClientIp": true,
"loggerId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/azuremonitor",
"sampling": {
"samplingType": "fixed",
"percentage": 100
}
}
}
],
"count": 1
}
Définitions
Nom | Description |
---|---|
Always |
Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer. |
Body |
Paramètres de journalisation du corps. |
Data |
|
Data |
|
Data |
Mode masquage des données. |
Diagnostic |
Représentation de liste de diagnostic paginée. |
Diagnostic |
Détails du diagnostic. |
Error |
Contrat champ d’erreur. |
Error |
Réponse d’erreur. |
Http |
Définit le protocole de corrélation à utiliser pour les diagnostics Application Insights. |
Http |
Paramètres de diagnostic des messages Http. |
Operation |
Format du nom de l’opération pour les télémetries Application Insights. La valeur par défaut est Name. |
Pipeline |
Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle. |
Sampling |
Paramètres d’échantillonnage pour diagnostic. |
Sampling |
Type d’échantillonnage. |
Verbosity |
Niveau de détail appliqué aux traces émises par les stratégies de suivi. |
AlwaysLog
Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer.
Nom | Type | Description |
---|---|---|
allErrors |
string |
Consignez toujours toutes les demandes erronées, quels que soient les paramètres d’échantillonnage. |
BodyDiagnosticSettings
Paramètres de journalisation du corps.
Nom | Type | Description |
---|---|---|
bytes |
integer |
Nombre d’octets du corps de la requête à consigner. |
DataMasking
Nom | Type | Description |
---|---|---|
headers |
Paramètres de masquage des en-têtes |
|
queryParams |
Paramètres de masquage pour les paramètres de requête d’URL |
DataMaskingEntity
Nom | Type | Description |
---|---|---|
mode |
Mode masquage des données. |
|
value |
string |
Nom d’une entité à masquer (par exemple, le nom d’un en-tête ou d’un paramètre de requête). |
DataMaskingMode
Mode masquage des données.
Nom | Type | Description |
---|---|---|
Hide |
string |
Masquer la présence d’une entité. |
Mask |
string |
Masquez la valeur d’une entité. |
DiagnosticCollection
Représentation de liste de diagnostic paginée.
Nom | Type | Description |
---|---|---|
count |
integer |
Nombre total d’enregistrements sur toutes les pages. |
nextLink |
string |
Lien de page suivante, le cas échéant. |
value |
Valeurs de page. |
DiagnosticContract
Détails du diagnostic.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nom de la ressource. |
properties.alwaysLog |
Spécifie le type de paramètres d’échantillonnage des messages qui ne doivent pas s’appliquer. |
|
properties.backend |
Paramètres de diagnostic pour les messages HTTP entrants/sortants vers le serveur principal |
|
properties.frontend |
Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle. |
|
properties.httpCorrelationProtocol |
Définit le protocole de corrélation à utiliser pour les diagnostics Application Insights. |
|
properties.logClientIp |
boolean |
Consignez le ClientIP. La valeur par défaut est false. |
properties.loggerId |
string |
ID de ressource d’un enregistreur d’événements cible. |
properties.metrics |
boolean |
Émettre des métriques personnalisées via une stratégie de métrique d’émission. Applicable uniquement aux paramètres de diagnostic Application Insights. |
properties.operationNameFormat |
Format du nom de l’opération pour les télémetries Application Insights. La valeur par défaut est Name. |
|
properties.sampling |
Paramètres d’échantillonnage pour diagnostic. |
|
properties.verbosity |
Niveau de détail appliqué aux traces émises par les stratégies de suivi. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
ErrorFieldContract
Contrat champ d’erreur.
Nom | Type | Description |
---|---|---|
code |
string |
Code d'erreur de niveau propriété. |
message |
string |
Représentation lisible par l’homme de l’erreur au niveau de la propriété. |
target |
string |
Nom de propriété. |
ErrorResponse
Réponse d’erreur.
Nom | Type | Description |
---|---|---|
error.code |
string |
Code d'erreur défini par le service. Ce code sert de sous-état pour le code d'erreur HTTP spécifié dans la réponse. |
error.details |
Liste des champs non valides envoyés dans la demande, en cas d’erreur de validation. |
|
error.message |
string |
Représentation contrôlable de visu de l’erreur. |
HttpCorrelationProtocol
Définit le protocole de corrélation à utiliser pour les diagnostics Application Insights.
Nom | Type | Description |
---|---|---|
Legacy |
string |
Injectez des en-têtes Request-Id et Request-Context avec des données de corrélation de requête. Consultez https://github.com/dotnet/corefx/blob/master/src/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md. |
None |
string |
Ne lisez pas et n’injectez pas d’en-têtes de corrélation. |
W3C |
string |
Injecter des en-têtes de contexte de trace. Consultez https://w3c.github.io/trace-context. |
HttpMessageDiagnostic
Paramètres de diagnostic des messages Http.
Nom | Type | Description |
---|---|---|
body |
Paramètres de journalisation du corps. |
|
dataMasking |
Paramètres de masquage des données. |
|
headers |
string[] |
Tableau d’en-têtes HTTP à journaliser. |
OperationNameFormat
Format du nom de l’opération pour les télémetries Application Insights. La valeur par défaut est Name.
Nom | Type | Description |
---|---|---|
Name |
string |
API_NAME ; rev=API_REVISION - OPERATION_NAME |
Url |
string |
HTTP_VERB URL |
PipelineDiagnosticSettings
Paramètres de diagnostic pour les messages HTTP entrants/sortants vers la passerelle.
Nom | Type | Description |
---|---|---|
request |
Paramètres de diagnostic pour la demande. |
|
response |
Paramètres de diagnostic pour la réponse. |
SamplingSettings
Paramètres d’échantillonnage pour diagnostic.
Nom | Type | Description |
---|---|---|
percentage |
number |
Taux d’échantillonnage pour l’échantillonnage à taux fixe. |
samplingType |
Type d’échantillonnage. |
SamplingType
Type d’échantillonnage.
Nom | Type | Description |
---|---|---|
fixed |
string |
Échantillonnage à taux fixe. |
Verbosity
Niveau de détail appliqué aux traces émises par les stratégies de suivi.
Nom | Type | Description |
---|---|---|
error |
string |
Seules les traces dont la valeur « gravité » est définie sur « error » sont envoyées à l’enregistreur d’événements attaché à cette instance de diagnostic. |
information |
string |
Les traces dont la valeur « severity » est définie sur « information » et « error » sont envoyées à l’enregistreur d’événements associé à ce instance de diagnostic. |
verbose |
string |
Toutes les traces émises par les stratégies de suivi seront envoyées au journal attaché à ce instance de diagnostic. |