BillingView

Message pour signaler les demandes de facturation via Eventstream.

Représentation JSON 
{
  "reportRequests": [
    {
      object (ReportRequest)
    }
  ]
}
Champs
reportRequests[]

object (ReportRequest)

Demandes de facturation à signaler pour cloud.eventstream.v2.ResourceEvent

ReportRequest

Message de requête pour la méthode services.report.

Représentation JSON 
{
  "serviceName": string,
  "operations": [
    {
      object (Operation)
    }
  ],
  "serviceConfigId": string
}
Champs
serviceName

string

Nom du service tel qu'il est spécifié dans sa configuration. Par exemple, "pubsub.googleapis.com".

Consultez google.api.Service pour obtenir la définition d'un nom de service.
operations[]

object (Operation)

Opérations à signaler.

En règle générale, le service doit signaler une opération par requête. Il est autorisé de regrouper plusieurs opérations dans une même requête, mais cela ne doit être fait que lorsque plusieurs opérations sont naturellement disponibles au moment de la création du rapport.

Le nombre d'opérations dans la même ReportRequest n'est pas limité, mais la taille de la ReportRequest ne doit pas dépasser 1 Mo. Pour en savoir plus sur le comportement en cas d'échec partiel, consultez ReportResponse.report_errors.
serviceConfigId

string

Spécifie la version de la configuration de service à utiliser pour traiter la requête.

Si aucune version n'est spécifiée ou si aucune version correspondante n'est trouvée, la dernière version sera utilisée.

Opération

Représente des informations concernant une opération.

Représentation JSON 
{
  "operationId": string,
  "operationName": string,
  "consumerId": string,
  "startTime": string,
  "endTime": string,
  "labels": {
    string: string,
    ...
  },
  "metricValueSets": [
    {
      object (MetricValueSet)
    }
  ],
  "logEntries": [
    {
      object (LogEntry)
    }
  ],
  "quotaProperties": {
    object (QuotaProperties)
  },
  "importance": enum (Importance),
  "userLabels": {
    string: string,
    ...
  },
  "resources": [
    {
      object (ResourceInfo)
    }
  ],
  "traceSpans": [
    {
      object (TraceSpan)
    }
  ]
}
Champs
operationId

string

Identité de l'opération. Cette valeur doit être unique dans le champ d'application du service qui a généré l'opération. Si le service appelle services.check() et services.report() sur la même opération, les deux appels doivent porter le même ID.

Nous vous recommandons d'utiliser la version 4 de l'UUID, mais ce n'est pas obligatoire. Dans les cas où une opération est calculée à partir d'informations existantes et où un ID idempotent est souhaitable à des fins de déduplication, la version 5 de l'UUID est recommandée. Pour en savoir plus, consultez la norme RFC 4122.
operationName

string

Nom complet de l'opération. Réservé pour une utilisation ultérieure.
consumerId

string

Identité du consommateur qui utilise le service. Ce champ doit être renseigné pour les opérations initiées par un consommateur, mais pas pour les opérations initiées par le service qui ne sont pas liées à un consommateur spécifique.

  • Il peut s'agir de l'un des formats suivants :
    • project:PROJECT_ID,
    • project_number:PROJECT_NUMBER,
    • projects/PROJECT_ID ou PROJECT_NUMBER,
    • folders/FOLDER_NUMBER,
    • organizations/ORGANIZATION_NUMBER,
    • api_key:API_KEY.
startTime

string (Timestamp format)

Obligatoire. Heure de début de l'opération.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Heure de fin de l'opération. Obligatoire lorsque l'opération est utilisée dans ServiceController.Report, mais facultatif lorsqu'elle est utilisée dans ServiceController.Check.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Libellés décrivant l'opération. Seuls les libellés suivants sont autorisés :

  • Libellés décrivant les ressources surveillées telles qu'elles sont définies dans la configuration du service.
  • Libellés par défaut des valeurs de métriques. Lorsqu'ils sont spécifiés, les libellés définis dans la valeur de métrique remplacent ces valeurs par défaut.
  • Les libellés suivants sont définis par Google Cloud Platform :
    • cloud.googleapis.com/location décrivant l'emplacement où l'opération a eu lieu.
    • servicecontrol.googleapis.com/userAgent en décrivant l'user-agent de la requête API ;
    • servicecontrol.googleapis.com/service_agent décrivant le service utilisé pour traiter la requête API (par exemple, ESP)
    • servicecontrol.googleapis.com/platform décrivant la plate-forme sur laquelle l'API est diffusée, comme App Engine, Compute Engine ou Kubernetes Engine.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
metricValueSets[]

object (MetricValueSet)

Représente des informations sur cette opération. Chaque MetricValueSet correspond à une métrique définie dans la configuration du service. Le type de données utilisé dans MetricValueSet doit correspondre à celui spécifié dans la définition de la métrique.

Dans une même opération, il n'est pas autorisé d'avoir plusieurs instances MetricValue qui ont les mêmes noms de métriques et des combinaisons de valeurs de libellé identiques. Si une requête contient de telles instances MetricValue en double, elle est entièrement rejetée avec une erreur d'argument non valide.
logEntries[]

object (LogEntry)

Représente les informations à enregistrer dans le journal.
quotaProperties

object (QuotaProperties)

Représente les propriétés nécessaires à la vérification du quota. Applicable uniquement si cette opération concerne une demande de vérification du quota. Si aucune valeur n'est spécifiée, aucune vérification de quota ne sera effectuée.
importance

enum (Importance)

NE PAS UTILISER. Il s'agit d'un champ expérimental.
userLabels

map (key: string, value: string)

Version Preview privée Cette fonctionnalité n'est disponible que pour les services approuvés.

Libellés définis par l'utilisateur pour la ressource à laquelle cette opération est associée.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
resources[]

object (ResourceInfo)

Ressources impliquées dans l'opération. Le nombre maximal d'entrées autorisé dans ce champ est de 100.
traceSpans[]

object (TraceSpan)

Non mis en œuvre. Liste des spans Cloud Trace. Les noms de spans doivent contenir l'ID du projet de destination, qui peut être le projet producteur ou consommateur.

MetricValueSet

Représente un ensemble de valeurs de métrique dans la même métrique. Chaque valeur de métrique de l'ensemble doit présenter une combinaison unique d'heure de début, d'heure de fin et de valeurs de libellé.

Représentation JSON 
{
  "metricName": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Champs
metricName

string

Nom de la métrique défini dans la configuration du service.
metricValues[]

object (MetricValue)

Valeurs de cette métrique.

MetricValue

Représente une seule valeur de métrique.

Représentation JSON 
{
  "labels": {
    string: string,
    ...
  },
  "startTime": string,
  "endTime": string,

  // Union field value can be only one of the following:
  "boolValue": boolean,
  "int64Value": string,
  "doubleValue": number,
  "stringValue": string,
  "distributionValue": {
    object (Distribution)
  },
  "moneyValue": {
    object (Money)
  }
  // End of list of possible types for union field value.
}
Champs
labels

map (key: string, value: string)

Libellés décrivant la valeur de la métrique. Consultez les commentaires sur google.api.servicecontrol.v1.Operation.labels pour connaître la relation de remplacement. Notez que cette carte ne doit pas contenir de libellés de ressources surveillées.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
startTime

string (Timestamp format)

Début de la période au cours de laquelle la mesure de cette valeur de métrique s'applique. La période présente une sémantique différente selon les types de métriques (cumulatives, delta et jauge). Pour en savoir plus, consultez la documentation sur la définition des métriques dans la configuration du service. Si aucune valeur n'est spécifiée, google.api.servicecontrol.v1.Operation.start_time sera utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Fin de la période à laquelle s'applique la mesure de cette valeur de métrique. Si aucune valeur n'est spécifiée, google.api.servicecontrol.v1.Operation.end_time sera utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Champ d'union value. Valeur. Le type de valeur utilisé dans la requête doit correspondre à la définition de la métrique dans la configuration du service. Dans le cas contraire, MetricValue est refusé. value ne peut être qu'un des éléments suivants :
boolValue

boolean

Une valeur booléenne.
int64Value

string (int64 format)

Valeur entière signée de 64 bits.
doubleValue

number

Valeur à virgule flottante avec deux décimales.
stringValue

string

Valeur de chaîne de texte.
distributionValue

object (Distribution)

Valeur de distribution.
moneyValue

object (Money)

Valeur monétaire.

Distribution

La distribution représente une distribution de fréquence des points d'échantillon à valeur double. Il contient la taille de la population de points d'échantillon, ainsi que des informations facultatives supplémentaires :

  • la moyenne arithmétique des échantillons.
  • le minimum et le maximum des échantillons.
  • la somme des écarts au carré des échantillons, utilisée pour calculer la variance.
  • un histogramme des valeurs des points d'échantillon ;
Représentation JSON 
{
  "count": string,
  "mean": number,
  "minimum": number,
  "maximum": number,
  "sumOfSquaredDeviation": number,
  "bucketCounts": [
    string
  ],
  "exemplars": [
    {
      object (Exemplar)
    }
  ],

  // Union field bucket_option can be only one of the following:
  "linearBuckets": {
    object (LinearBuckets)
  },
  "exponentialBuckets": {
    object (ExponentialBuckets)
  },
  "explicitBuckets": {
    object (ExplicitBuckets)
  }
  // End of list of possible types for union field bucket_option.
}
Champs
count

string (int64 format)

Nombre total d'échantillons dans la distribution. Doit être supérieur ou égal à 0.
mean

number

Moyenne arithmétique des échantillons de la distribution. Si count est nul, ce champ doit être nul.
minimum

number

Valeur minimale de la population de valeurs. Ignoré si count est égal à zéro.
maximum

number

Valeur maximale de la population de valeurs. Ignoré si count est égal à zéro.
sumOfSquaredDeviation

number

La somme des écarts au carré par rapport à la moyenne : Sum[i=1..count]((x_i - mean)^2), où chaque x_i est une valeur d'échantillon. Si count est égal à zéro, ce champ doit être égal à zéro. Sinon, la validation de la requête échoue.
bucketCounts[]

string (int64 format)

Nombre d'échantillons dans chaque bucket d'histogramme. bucketCounts sont facultatifs. Si elles sont présentes, elles doivent être égales à la valeur count.

Les buckets sont définis ci-dessous dans bucket_option. Il y a N buckets. bucketCounts[0] correspond au nombre d'échantillons dans le bucket "Sous-dépassement". bucketCounts[1] à bucketCounts[N-1] correspondent au nombre d'échantillons dans chacun des buckets finis. bucketCounts[N] correspond au nombre d'échantillons dans le bucket de dépassement. Pour en savoir plus, consultez les commentaires de bucket_option ci-dessous.

Tout suffixe de zéros à la fin peut être omis.
exemplars[]

object (Exemplar)

Exemples de points. Doit être dans l'ordre croissant du champ value.

Champ d'union bucket_option. Définit les buckets dans l'histogramme. bucket_option et bucket_counts doivent être tous les deux définis ou tous les deux non définis.

Les buckets sont numérotés de 0 à N, pour un total de N+1 buckets. Il doit y avoir au moins deux buckets (un histogramme à un seul bucket ne fournit aucune information qui ne soit déjà fournie par count).

Le premier bucket est le bucket de dépassement de capacité négatif, dont la limite inférieure est -inf. Le dernier bucket est le bucket de dépassement de capacité, dont la limite supérieure est +inf. Tous les autres buckets (le cas échéant) sont appelés buckets "finis", car ils ont des limites inférieure et supérieure finies. Comme décrit ci-dessous, il existe trois façons de définir les buckets finis.

(1) Buckets à largeur constante. (2) Buckets dont la largeur augmente de manière exponentielle. (3) Paliers avec des largeurs arbitraires fournies par l'utilisateur.

Dans tous les cas, les buckets couvrent l'ensemble de la droite numérique réelle (-inf, +inf). Les limites supérieures des buckets sont exclusives et les limites inférieures sont incluses. La limite supérieure du bucket "underflow" est égale à la limite inférieure du plus petit bucket fini, tandis que la limite inférieure du bucket "overflow" est égale à la limite supérieure du plus grand bucket fini. bucket_option ne peut être qu'un des éléments suivants :
linearBuckets

object (LinearBuckets)

Buckets de largeur constante.
exponentialBuckets

object (ExponentialBuckets)

Buckets dont la largeur augmente de manière exponentielle.
explicitBuckets

object (ExplicitBuckets)

Buckets avec une largeur arbitraire fournie par l'utilisateur.

LinearBuckets

Description des buckets à largeur constante.

Représentation JSON 
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
Champs
numFiniteBuckets

integer

Nombre de buckets finis. Avec les buckets de dépassement de capacité négatif et positif, le nombre total de buckets est numFiniteBuckets + 2. Pour en savoir plus, consultez les commentaires sur bucketOptions.
width

number

Le i-ième bucket linéaire couvre l'intervalle [offset + (i-1) * width, offset + i * width), où i est compris entre 1 et numFiniteBuckets, inclus. Doit être strictement positif.
offset

number

Le i-ième bucket linéaire couvre l'intervalle [offset + (i-1) * width, offset + i * width), où i est compris entre 1 et numFiniteBuckets, inclus.

ExponentialBuckets

Description des buckets dont la largeur augmente de manière exponentielle.

Représentation JSON 
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
Champs
numFiniteBuckets

integer

Nombre de buckets finis. Avec les buckets de dépassement de capacité négatif et positif, le nombre total de buckets est numFiniteBuckets + 2. Pour en savoir plus, consultez les commentaires sur bucketOptions.
growthFactor

number

Le i-ième bucket exponentiel couvre l'intervalle [scale * growthFactor^(i-1), scale * growthFactor^i), où i est compris entre 1 et numFiniteBuckets inclus. La valeur doit être supérieure à 1.0.
scale

number

Le i-ième bucket exponentiel couvre l'intervalle [scale * growthFactor^(i-1), scale * growthFactor^i), où i est compris entre 1 et numFiniteBuckets inclus. Doit être supérieur à 0.

ExplicitBuckets

Description des buckets avec une largeur arbitraire fournie par l'utilisateur.

Représentation JSON 
{
  "bounds": [
    number
  ]
}
Champs
bounds[]

number

"bound" est une liste de limites strictement croissantes entre les buckets. Notez qu'une liste de longueur N-1 définit N buckets en raison de la clôture. Pour en savoir plus, consultez les commentaires sur bucketOptions.

Le i-ième bucket fini couvre l'intervalle [bound[i-1], bound[i]), où i est compris entre 1 et bound_size() - 1. Notez qu'il n'y a pas de buckets finis si "bound" ne contient qu'un seul élément. Dans ce cas particulier, la limite unique définit la limite entre les buckets de dépassement de capacité négatif et positif.

bucket number lower bound upper bound i == 0 (underflow) -inf bound[i] 0 < i < bound_size() bound[i-1] bound[i] i == bound_size() (overflow) bound[i-1] +inf

Exemplar

Les exemples sont des points qui peuvent être utilisés pour annoter les valeurs de distribution agrégées. Il s'agit de métadonnées qui fournissent des informations sur une valeur spécifique ajoutée à un bucket de distribution, comme un ID de trace actif lorsqu'une valeur a été ajoutée. Ils peuvent contenir des informations supplémentaires, telles que des exemples de valeurs et des codes temporels, l'origine, etc.

Représentation JSON 
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Champs
value

number

Valeur du point exemplaire. Cette valeur détermine le bucket auquel appartient l'exemplaire.
timestamp

string (Timestamp format)

Heure d'observation (échantillonnage) de la valeur ci-dessus.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
attachments[]

object

Informations contextuelles sur la valeur de l'exemple. Exemples :

Trace : type.googleapis.com/google.monitoring.v3.SpanContext

Chaîne littérale : type.googleapis.com/google.protobuf.StringValue

Libellés supprimés lors de l'agrégation : type.googleapis.com/google.monitoring.v3.DroppedLabels

Un seul type de pièce jointe est autorisé par exemple, et le système s'assure que cette règle est respectée.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.

Valeur monétaire

Représente un montant associé à un type de devise.

Représentation JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Champs
currencyCode

string

Code de devise à trois lettres défini par la norme ISO 4217.
units

string (int64 format)

Unités entières du montant. Par exemple, si currencyCode est défini sur "USD", une unité correspond à un dollar américain.
nanos

integer

Nombre de nano-unités (10^-9) du montant. La valeur doit être comprise entre -999 999 999 et +999 999 999 inclus. Si units est positif, nanos doit être positif ou nul. Si units est égal à zéro, nanos peut être positif, nul ou négatif. Si units est négatif, nanos doit être négatif ou nul. Par exemple, -1,75 $ est représenté par units=-1 et nanos=-750 000 000.

LogEntry

Entrée de journal individuelle.

Représentation JSON 
{
  "name": string,
  "timestamp": string,
  "severity": enum (LogSeverity),
  "httpRequest": {
    object (HttpRequest)
  },
  "trace": string,
  "insertId": string,
  "labels": {
    string: string,
    ...
  },
  "operation": {
    object (LogEntryOperation)
  },
  "sourceLocation": {
    object (LogEntrySourceLocation)
  },

  // Union field payload can be only one of the following:
  "protoPayload": {
    "@type": string,
    field1: ...,
    ...
  },
  "textPayload": string,
  "structPayload": {
    object
  }
  // End of list of possible types for union field payload.
}
Champs
name

string

Obligatoire. Journal auquel appartient cette entrée de journal. Exemples : "syslog", "book_log".
timestamp

string (Timestamp format)

Heure à laquelle l'événement décrit par l'entrée de journal s'est produit. Si aucune valeur n'est spécifiée, la valeur par défaut est l'heure de début de l'opération.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
severity

enum (LogSeverity)

Gravité de l'entrée de journal. La valeur par défaut est LogSeverity.DEFAULT.
httpRequest

object (HttpRequest)

Facultatif. Informations sur la requête HTTP associée à cette entrée de journal, le cas échéant.
trace

string

Facultatif. Nom de ressource de la trace associée à l'entrée de journal, le cas échéant. Si ce champ contient un nom de ressource relatif, vous pouvez supposer que le nom est relatif à //tracing.googleapis.com. Exemple : projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824
insertId

string

ID unique de l'entrée de journal utilisé pour la déduplication. Si elle est omise, l'implémentation en générera une en fonction de l'opérationId.
labels

map (key: string, value: string)

Ensemble de données (clé, valeur) définies par l'utilisateur qui fournissent des informations supplémentaires sur l'entrée de journal.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
operation

object (LogEntryOperation)

Facultatif. Informations sur une opération associée à l'entrée de journal, le cas échéant.
sourceLocation

object (LogEntrySourceLocation)

Facultatif. Les informations d'emplacement du code source associées à l'entrée de journal, le cas échéant.
Champ d'union payload. Charge utile de l'entrée de journal, qui peut être de plusieurs types. payload ne peut être qu'un des éléments suivants :
protoPayload

object

Charge utile de l'entrée de journal, représentée par un tampon de protocole exprimé sous la forme d'un objet JSON. Le seul type accepté actuellement est AuditLog.

Objet contenant des champs d'un type arbitraire. Un champ supplémentaire "@type" contient un URI identifiant le type. Exemple : { "id": 1234, "@type": "types.example.com/standard/id" }.
textPayload

string

Charge utile de l'entrée de journal, représentée par une chaîne Unicode (UTF-8).
structPayload

object (Struct format)

Charge utile de l'entrée de journal, représentée par une structure exprimée sous la forme d'un objet JSON.

HttpRequest

Proto courant pour la journalisation des requêtes HTTP. Ne contient que la sémantique définie par la spécification HTTP. Les informations de journalisation spécifiques au produit DOIVENT être définies dans un message distinct.

Représentation JSON 
{
  "requestMethod": string,
  "requestUrl": string,
  "requestSize": string,
  "status": integer,
  "responseSize": string,
  "userAgent": string,
  "remoteIp": string,
  "serverIp": string,
  "referer": string,
  "latency": string,
  "cacheLookup": boolean,
  "cacheHit": boolean,
  "cacheValidatedWithOriginServer": boolean,
  "cacheFillBytes": string,
  "protocol": string
}
Champs
requestMethod

string

Méthode de la requête. Exemples : "GET", "HEAD", "PUT", "POST".
requestUrl

string

Schéma (http, https), nom d'hôte, chemin d'accès et partie de requête de l'URL demandée. Exemple : "http://example.com/some/info?color=red".
requestSize

string (int64 format)

Taille du message de requête HTTP en octets, y compris les en-têtes et le corps de la requête.
status

integer

Code de réponse indiquant l'état de la réponse. Exemples : 200, 404.
responseSize

string (int64 format)

Taille (en octets) du message de réponse HTTP renvoyé au client, y compris les en-têtes et le corps de la réponse.
userAgent

string

User-agent envoyé par le client. Exemple : "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".
remoteIp

string

Adresse IP (IPv4 ou IPv6) du client qui a émis la requête HTTP. Exemples : "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".
serverIp

string

Adresse IP (IPv4 ou IPv6) du serveur d'origine auquel la requête a été envoyée.
referer

string

URL de provenance de la requête, telle que définie dans Définitions des champs d'en-tête HTTP/1.1.
latency

string (Duration format)

Latence de traitement des requêtes sur le serveur, entre le moment où la requête a été reçue et celui où la réponse a été envoyée.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
cacheLookup

boolean

Indique si une recherche dans le cache a été tentée.
cacheHit

boolean

Indique si une entité a été diffusée à partir du cache (avec ou sans validation).
cacheValidatedWithOriginServer

boolean

Indique si la réponse a été validée ou non avec le serveur d'origine avant d'être diffusée à partir du cache. Ce champ n'est pertinent que si cacheHit est défini sur "True".
cacheFillBytes

string (int64 format)

Nombre d'octets de réponse HTTP insérés dans le cache. Défini uniquement lorsqu'une tentative de remplissage du cache a été effectuée.
protocol

string

Protocole utilisé pour la requête. Exemples : "HTTP/1.1", "HTTP/2", "websocket"

LogEntryOperation

Informations supplémentaires sur une opération potentiellement de longue durée à laquelle une entrée de journal est associée.

Représentation JSON 
{
  "id": string,
  "producer": string,
  "first": boolean,
  "last": boolean
}
Champs
id

string

Facultatif. Identifiant d'opération arbitraire. Les entrées de journal ayant le même identifiant sont considérées comme faisant partie de la même opération.
producer

string

Facultatif. Identifiant de producteur arbitraire. La combinaison de id et producer doit être unique. Exemples pour producer : "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".
first

boolean

Facultatif. Définissez cette valeur sur "True" s'il s'agit de la première entrée de journal de l'opération.
last

boolean

Facultatif. Définissez cette valeur sur "True" s'il s'agit de la dernière entrée de journal de l'opération.

LogEntrySourceLocation

Informations supplémentaires sur l'emplacement du code source qui a produit l'entrée de journal.

Représentation JSON 
{
  "file": string,
  "line": string,
  "function": string
}
Champs
file

string

Facultatif. Nom du fichier source. Selon l'environnement d'exécution, il peut s'agir d'un nom simple ou d'un nom complet.
line

string (int64 format)

Facultatif. Ligne dans le fichier source. (0 indique qu'aucun numéro de ligne n'est disponible).
function

string

Facultatif. Nom lisible de la fonction ou de la méthode appelée, avec un contexte facultatif tel que le nom de la classe ou du package. Ces informations peuvent être utilisées dans des contextes tels que la visionneuse de journaux, où un fichier et un numéro de ligne ont moins de sens. Le format peut varier selon la langue. Par exemple : qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).

QuotaProperties

Représente les propriétés nécessaires aux opérations de quota.

Représentation JSON 
{
  "quotaMode": enum (QuotaMode)
}
Champs
quotaMode

enum (QuotaMode)

Mode de quota pour cette opération.

ResourceInfo

Décrit une ressource associée à cette opération.

Représentation JSON 
{
  "resourceContainer": string,
  "resourceName": string,
  "resourceLocation": string,
  "permission": string
}
Champs
resourceContainer

string

Identifiant du parent de cette instance de ressource. Doit être dans l'un des formats suivants : - projects/<project-id or project-number> - folders/<folder-id> - organizations/<organization-id>
resourceName

string

Nom de la ressource. Cela sert à des fins d'audit.
resourceLocation

string

Emplacement de la ressource. Si elle n'est pas vide, la ressource sera vérifiée par rapport à la règle concernant les lieux. La valeur doit être une zone, une région ou un emplacement multirégional valides. Par exemple : "europe-west4" ou "northamerica-northeast1-a"
permission

string

Autorisation de ressource requise pour cette demande.

TraceSpan

Un span représente une opération unique dans une trace. Les spans peuvent être imbriqués pour former une arborescence de trace. Une trace contient souvent un span racine qui décrit la latence de bout en bout, ainsi qu'un ou plusieurs sous-spans pour ses sous-opérations. Une trace peut également contenir plusieurs spans racines, ou aucun. Les portées n'ont pas besoin d'être contiguës. Il peut y avoir des écarts ou des chevauchements entre les portées d'une trace.

Représentation JSON 
{
  "name": string,
  "spanId": string,
  "parentSpanId": string,
  "displayName": {
    object (TruncatableString)
  },
  "startTime": string,
  "endTime": string,
  "attributes": {
    object (Attributes)
  },
  "status": {
    object (Status)
  },
  "sameProcessAsParentSpan": boolean,
  "childSpanCount": integer,
  "spanKind": enum (SpanKind)
}
Champs
name

string

Nom de ressource du span au format suivant :

projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/[SPAN_ID]

[TRACE_ID] est un identifiant unique pour une trace dans un projet. Il s'agit d'un encodage hexadécimal à 32 caractères d'un tableau de 16 octets.

[SPAN_ID] est un identifiant unique pour une portée dans une trace. Il s'agit d'un encodage hexadécimal à 16 caractères d'un tableau de 8 octets.
spanId

string

Partie [SPAN_ID] du nom de ressource de la portée.
parentSpanId

string

[SPAN_ID] du segment parent de ce segment. Si la portée est une portée racine, ce champ doit être vide.
displayName

object (TruncatableString)

Description de l'opération de la portée (128 octets maximum). Stackdriver Trace affiche la description dans la console Google Cloud Platform. Par exemple, le nom à afficher peut être un nom de méthode qualifié ou un nom de fichier et un numéro de ligne où l'opération est appelée. Nous vous recommandons d'utiliser le même nom à afficher dans une application et au même point d'appel. Cela permet de corréler plus facilement les portées dans différentes traces.
startTime

string (Timestamp format)

Heure de début de la période. Du côté client, il s'agit de l'heure conservée par la machine locale où l'exécution de la portée commence. Côté serveur, il s'agit du moment où le gestionnaire d'application du serveur commence à s'exécuter.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Heure de fin de la période. Du côté client, il s'agit de l'heure conservée par la machine locale à laquelle l'exécution de la portée se termine. Côté serveur, il s'agit du moment où le gestionnaire d'application serveur cesse de s'exécuter.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
attributes

object (Attributes)

Ensemble d'attributs du span. Vous pouvez ajouter jusqu'à 32 attributs par étendue.
status

object (Status)

État final facultatif de cette étendue.
sameProcessAsParentSpan

boolean

(Facultatif) Définissez ce paramètre pour indiquer si cette étendue se trouve dans le même processus que son parent. Si vous ne définissez pas ce paramètre, Stackdriver Trace ne pourra pas profiter de ces informations utiles.
childSpanCount

integer

Nombre facultatif d'étendues enfants générées lorsque cette étendue était active. Si cette option est définie, elle permet à l'implémentation de détecter les portées enfants manquantes.
spanKind

enum (SpanKind)

Distingue les portées générées dans un contexte particulier. Par exemple, deux portées portant le même nom peuvent être distinguées à l'aide de CLIENT (appelant) et SERVER (appelé) pour identifier un appel RPC.

TruncatableString

Représente une chaîne pouvant être raccourcie à une longueur spécifiée.

Représentation JSON 
{
  "value": string,
  "truncatedByteCount": integer
}
Champs
value

string

Chaîne raccourcie. Par exemple, si la chaîne d'origine comporte 500 octets et que la limite de la chaîne est de 128 octets, value contient les 128 premiers octets de la chaîne de 500 octets.

La troncature se produit toujours à la limite d'un caractère UTF-8. Si la chaîne contient des caractères multi-octets, la longueur de la chaîne raccourcie peut être inférieure à la limite de taille.
truncatedByteCount

integer

Nombre d'octets supprimés de la chaîne d'origine. Si cette valeur est définie sur 0, cela signifie que la chaîne n'a pas été raccourcie.

Attributs

Ensemble d'attributs, chacun au format [KEY]:[VALUE].

Représentation JSON 
{
  "attributeMap": {
    string: {
      object (AttributeValue)
    },
    ...
  },
  "droppedAttributesCount": integer
}
Champs
attributeMap

map (key: string, value: object (AttributeValue))

Ensemble d'attributs. La clé de chaque attribut peut comporter jusqu'à 128 octets. La valeur peut être une chaîne de 256 octets maximum, un entier signé de 64 bits ou les valeurs booléennes true et false. Exemple :

"/instance_id": "my-instance"
"/http/userAgent": ""
"/http/request_bytes": 300
"example.com/myattribute": true

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
droppedAttributesCount

integer

Nombre d'attributs supprimés. Les attributs peuvent être supprimés si leurs clés sont trop longues ou s'il y a trop d'attributs. Si cette valeur est définie sur 0, tous les attributs sont valides.

AttributeValue

Types autorisés pour [VALUE] dans un attribut [KEY]:[VALUE].

Représentation JSON 
{

  // Union field value can be only one of the following:
  "stringValue": {
    object (TruncatableString)
  },
  "intValue": string,
  "boolValue": boolean
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Type de la valeur. value ne peut être qu'un des éléments suivants :
stringValue

object (TruncatableString)

Chaîne de 256 octets maximum.
intValue

string (int64 format)

Entier signé de 64 bits
boolValue

boolean

Valeur booléenne représentée par true ou false.