BillingView

Pesan untuk melaporkan permintaan penagihan melalui Eventstream.

Representasi JSON
{
  "reportRequests": [
    {
      object (ReportRequest)
    }
  ]
}
Kolom
reportRequests[]

object (ReportRequest)

Permintaan penagihan yang akan dilaporkan untuk cloud.eventstream.v2.ResourceEvent

ReportRequest

Pesan permintaan untuk metode services.report.

Representasi JSON
{
  "serviceName": string,
  "operations": [
    {
      object (Operation)
    }
  ],
  "serviceConfigId": string
}
Kolom
serviceName

string

Nama layanan seperti yang ditentukan dalam konfigurasi layanannya. Misalnya, "pubsub.googleapis.com".

Lihat google.api.Service untuk mengetahui definisi nama layanan.

operations[]

object (Operation)

Operasi yang akan dilaporkan.

Biasanya, layanan harus melaporkan satu operasi per permintaan. Menempatkan beberapa operasi dalam satu permintaan diizinkan, tetapi hanya boleh digunakan jika beberapa operasi tersedia secara alami pada saat laporan.

Tidak ada batasan jumlah operasi dalam ReportRequest yang sama, tetapi ukuran ReportRequest tidak boleh lebih besar dari 1 MB. Lihat ReportResponse.report_errors untuk perilaku kegagalan parsial.

serviceConfigId

string

Menentukan versi konfigurasi layanan yang harus digunakan untuk memproses permintaan.

Jika tidak ditentukan atau tidak ada versi yang cocok, versi terbaru akan digunakan.

Operasi

Menampilkan informasi terkait operasi.

Representasi 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)
    }
  ]
}
Kolom
operationId

string

Identitas operasi. ID ini harus unik dalam cakupan layanan yang menghasilkan operasi. Jika layanan memanggil services.check() dan services.report() pada operasi yang sama, kedua panggilan harus memiliki ID yang sama.

UUID versi 4 direkomendasikan, meskipun tidak wajib. Dalam skenario ketika operasi dihitung dari informasi yang ada dan ID idempoten diinginkan untuk tujuan penghapusan duplikat, UUID versi 5 direkomendasikan. Lihat RFC 4122 untuk mengetahui detailnya.

operationName

string

Nama operasi yang sepenuhnya memenuhi syarat. Dipesan untuk penggunaan di masa mendatang.

consumerId

string

Identitas konsumen yang menggunakan layanan. Kolom ini harus diisi untuk operasi yang dimulai oleh konsumen, tetapi tidak untuk operasi yang dimulai oleh layanan yang tidak terkait dengan konsumen tertentu.

  • Ini dapat berupa salah satu format berikut:
    • project:PROJECT_ID,
    • project_number:PROJECT_NUMBER,
    • projects/PROJECT_ID atau PROJECT_NUMBER,
    • folders/FOLDER_NUMBER,
    • organizations/ORGANIZATION_NUMBER,
    • api_key:API_KEY.
startTime

string (Timestamp format)

Wajib. Waktu mulai operasi.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Waktu berakhir operasi. Wajib ada saat operasi digunakan di ServiceController.Report, tetapi opsional saat operasi digunakan di ServiceController.Check.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Label yang menjelaskan operasi. Hanya label berikut yang diizinkan:

  • Label yang mendeskripsikan resource yang dipantau seperti yang ditentukan dalam konfigurasi layanan.
  • Label default nilai metrik. Jika ditentukan, label yang ditentukan dalam nilai metrik akan menggantikan nilai default ini.
  • Label berikut yang ditentukan oleh Google Cloud Platform:
    • cloud.googleapis.com/location yang menjelaskan lokasi terjadinya operasi,
    • servicecontrol.googleapis.com/userAgent menjelaskan agen pengguna permintaan API,
    • servicecontrol.googleapis.com/service_agent yang menjelaskan layanan yang digunakan untuk menangani permintaan API (misalnya, ESP),
    • servicecontrol.googleapis.com/platform yang menjelaskan platform tempat API ditayangkan, seperti App Engine, Compute Engine, atau Kubernetes Engine.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

metricValueSets[]

object (MetricValueSet)

Menampilkan informasi tentang operasi ini. Setiap MetricValueSet sesuai dengan metrik yang ditentukan dalam konfigurasi layanan. Jenis data yang digunakan dalam MetricValueSet harus sesuai dengan jenis data yang ditentukan dalam definisi metrik.

Dalam satu operasi, tidak boleh ada lebih dari satu instance MetricValue yang memiliki nama metrik yang sama dan kombinasi nilai label yang identik. Jika permintaan memiliki instance MetricValue duplikat seperti itu, seluruh permintaan akan ditolak dengan error argumen tidak valid.

logEntries[]

object (LogEntry)

Menampilkan informasi yang akan dicatat.

quotaProperties

object (QuotaProperties)

Mewakili properti yang diperlukan untuk pemeriksaan kuota. Hanya berlaku jika operasi ini adalah untuk permintaan pemeriksaan kuota. Jika tidak ditentukan, tidak ada pemeriksaan kuota yang akan dilakukan.

importance

enum (Importance)

JANGAN GUNAKAN. Kolom ini bersifat eksperimental.

userLabels

map (key: string, value: string)

Pratinjau Pribadi. Fitur ini hanya tersedia untuk layanan yang disetujui.

Label yang ditentukan pengguna untuk resource yang terkait dengan operasi ini.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

resources[]

object (ResourceInfo)

Resource yang terlibat dalam operasi. Jumlah maksimum entri yang didukung di kolom ini adalah 100.

traceSpans[]

object (TraceSpan)

Tidak diterapkan. Daftar rentang Cloud Trace. Nama rentang harus berisi ID project tujuan yang dapat berupa project produsen atau konsumen.

MetricValueSet

Mewakili sekumpulan nilai metrik dalam metrik yang sama. Setiap nilai metrik dalam set harus memiliki kombinasi unik dari waktu mulai, waktu berakhir, dan nilai label.

Representasi JSON
{
  "metricName": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Kolom
metricName

string

Nama metrik yang ditentukan dalam konfigurasi layanan.

metricValues[]

object (MetricValue)

Nilai dalam metrik ini.

MetricValue

Menampilkan nilai metrik tunggal.

Representasi 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.
}
Kolom
labels

map (key: string, value: string)

Label yang menjelaskan nilai metrik. Lihat komentar di google.api.servicecontrol.v1.Operation.labels untuk hubungan yang menggantikan. Perhatikan bahwa peta ini tidak boleh berisi label resource yang dipantau.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

startTime

string (Timestamp format)

Awal jangka waktu saat pengukuran nilai metrik ini berlaku. Jangka waktu memiliki semantik yang berbeda untuk berbagai jenis metrik (kumulatif, delta, dan pengukur). Lihat dokumentasi definisi metrik dalam konfigurasi layanan untuk mengetahui detailnya. Jika tidak ditentukan, google.api.servicecontrol.v1.Operation.start_time akan digunakan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Akhir jangka waktu yang berlaku untuk pengukuran nilai metrik ini. Jika tidak ditentukan, google.api.servicecontrol.v1.Operation.end_time akan digunakan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union value. Nilai. Jenis nilai yang digunakan dalam permintaan harus sesuai dengan definisi metrik dalam konfigurasi layanan, jika tidak, MetricValue akan ditolak. value hanya ada berupa salah satu diantara berikut:
boolValue

boolean

Nilai boolean.

int64Value

string (int64 format)

Nilai bilangan bulat 64-bit bertanda.

doubleValue

number

Nilai floating point presisi ganda.

stringValue

string

Nilai string teks.

distributionValue

object (Distribution)

Nilai distribusi.

moneyValue

object (Money)

Nilai uang.

Distribusi

Distribusi merepresentasikan distribusi frekuensi titik sampel bernilai ganda. File ini berisi ukuran populasi titik sampel beserta informasi opsional tambahan:

  • rata-rata aritmatika sampel
  • nilai minimum dan maksimum sampel
  • jumlah kuadrat deviasi sampel, yang digunakan untuk menghitung varians
  • histogram nilai titik sampel
Representasi 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.
}
Kolom
count

string (int64 format)

Jumlah total sampel dalam distribusi. Harus >= 0.

mean

number

Rata-rata aritmetika sampel dalam distribusi. Jika count adalah nol, kolom ini harus nol.

minimum

number

Nilai minimum populasi nilai. Diabaikan jika count adalah nol.

maximum

number

Nilai maksimum populasi nilai. Diabaikan jika count adalah nol.

sumOfSquaredDeviation

number

Jumlah kuadrat deviasi dari rata-rata: Sum[i=1..count]((x_i - mean)^2) dengan setiap x_i adalah nilai sampel. Jika count adalah nol, kolom ini harus nol, jika tidak, validasi permintaan akan gagal.

bucketCounts[]

string (int64 format)

Jumlah sampel di setiap bucket histogram. bucketCounts bersifat opsional. Jika ada, jumlahnya harus sama dengan nilai count.

Bucket ditentukan di bawah dalam bucket_option. Ada N bucket. bucketCounts[0] adalah jumlah sampel dalam bucket underflow. bucketCounts[1] hingga bucketCounts[N-1] adalah jumlah sampel di setiap bucket terbatas. Dan bucketCounts[N] adalah jumlah sampel dalam bucket overflow. Lihat komentar bucket_option di bawah untuk mengetahui detail selengkapnya.

Semua akhiran nol di belakang dapat dihilangkan.

exemplars[]

object (Exemplar)

Contoh poin. Harus dalam urutan menaik kolom value.

Kolom union bucket_option. Menentukan bucket dalam histogram. bucket_option dan bucket_counts harus disetel, atau tidak disetel.

Bucket diberi nomor dalam rentang [0, N], dengan total N+1 bucket. Harus ada minimal dua bucket (histogram satu bucket tidak memberikan informasi yang belum diberikan oleh count).

Bucket pertama adalah bucket underflow yang memiliki batas bawah -inf. Bucket terakhir adalah bucket luapan yang memiliki batas atas +inf. Semua bucket lainnya (jika ada) disebut bucket "terbatas" karena memiliki batas bawah dan atas yang terbatas. Seperti yang dijelaskan di bawah, ada tiga cara untuk menentukan bucket terbatas.

(1) Bucket dengan lebar konstan. (2) Bucket dengan lebar yang bertambah secara eksponensial. (3) Kelompok dengan lebar yang ditentukan pengguna secara arbitrer.

Dalam semua kasus, bucket mencakup seluruh garis bilangan riil (-inf, +inf). Batas atas bucket bersifat eksklusif dan batas bawah bersifat inklusif. Batas atas bucket underflow sama dengan batas bawah bucket hingga terkecil; batas bawah bucket overflow sama dengan batas atas bucket hingga terbesar. bucket_option hanya dapat berupa salah satu dari berikut:

linearBuckets

object (LinearBuckets)

Bucket dengan lebar konstan.

exponentialBuckets

object (ExponentialBuckets)

Bucket dengan lebar yang bertambah secara eksponensial.

explicitBuckets

object (ExplicitBuckets)

Bucket dengan lebar yang ditentukan pengguna secara arbitrer.

LinearBuckets

Mendeskripsikan bucket dengan lebar konstan.

Representasi JSON
{
  "numFiniteBuckets": integer,
  "width": number,
  "offset": number
}
Kolom
numFiniteBuckets

integer

Jumlah bucket terbatas. Dengan bucket underflow dan overflow, jumlah total bucket adalah numFiniteBuckets + 2. Lihat komentar di bucketOptions untuk mengetahui detailnya.

width

number

Bucket linear ke-i mencakup interval [offset + (i-1) * width, offset + i * width) dengan i berkisar dari 1 hingga numFiniteBuckets, inklusif. Harus benar-benar positif.

offset

number

Bucket linear ke-i mencakup interval [offset + (i-1) * width, offset + i * width) dengan i berkisar dari 1 hingga numFiniteBuckets, inklusif.

ExponentialBuckets

Mendeskripsikan bucket dengan lebar yang tumbuh secara eksponensial.

Representasi JSON
{
  "numFiniteBuckets": integer,
  "growthFactor": number,
  "scale": number
}
Kolom
numFiniteBuckets

integer

Jumlah bucket terbatas. Dengan bucket underflow dan overflow, jumlah total bucket adalah numFiniteBuckets + 2. Lihat komentar di bucketOptions untuk mengetahui detailnya.

growthFactor

number

Bucket eksponensial ke-i mencakup interval [scale * growthFactor^(i-1), scale * growthFactor^i) dengan i berkisar dari 1 hingga numFiniteBuckets inklusif. Harus lebih besar dari 1.0.

scale

number

Bucket eksponensial ke-i mencakup interval [scale * growthFactor^(i-1), scale * growthFactor^i) dengan i berkisar dari 1 hingga numFiniteBuckets inklusif. Harus > 0.

ExplicitBuckets

Mendeskripsikan bucket dengan lebar yang ditentukan pengguna secara arbitrer.

Representasi JSON
{
  "bounds": [
    number
  ]
}
Kolom
bounds[]

number

'bound' adalah daftar batas yang meningkat secara ketat di antara bucket. Perhatikan bahwa daftar panjang N-1 menentukan N bucket karena fenceposting. Lihat komentar di bucketOptions untuk mengetahui detailnya.

Bucket terbatas ke-i mencakup interval [bound[i-1], bound[i]) dengan i berkisar dari 1 hingga bound_size() - 1. Perhatikan bahwa tidak ada bucket terbatas sama sekali jika 'bound' hanya berisi satu elemen; dalam kasus khusus tersebut, satu batas menentukan batas antara bucket underflow dan overflow.

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

Contoh

Contoh adalah titik contoh yang dapat digunakan untuk memberi anotasi pada nilai distribusi gabungan. Metadata ini memberikan informasi tentang nilai tertentu yang ditambahkan ke bucket Distribusi, seperti ID rekaman aktivitas yang aktif saat nilai ditambahkan. File ini dapat berisi informasi lebih lanjut, seperti nilai dan stempel waktu contoh, asal, dll.

Representasi JSON
{
  "value": number,
  "timestamp": string,
  "attachments": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Kolom
value

number

Nilai titik contoh. Nilai ini menentukan bucket tempat contoh berada.

timestamp

string (Timestamp format)

Waktu pengamatan (sampling) nilai di atas.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

attachments[]

object

Informasi kontekstual tentang nilai contoh. Contohnya adalah:

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

String literal: type.googleapis.com/google.protobuf.StringValue

Label yang dihapus selama penggabungan: type.googleapis.com/google.monitoring.v3.DroppedLabels

Hanya boleh ada satu lampiran dari jenis pesan tertentu dalam satu contoh, dan hal ini diterapkan oleh sistem.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Uang

Mewakili jumlah uang dengan jenis mata uangnya.

Representasi JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Kolom
currencyCode

string

Kode mata uang tiga huruf yang ditentukan dalam ISO 4217.

units

string (int64 format)

Seluruh unit jumlahnya. Misalnya, jika currencyCode adalah "USD", maka 1 unit adalah satu dolar AS.

nanos

integer

Jumlah unit nano (10^-9) dari jumlah. Nilainya harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos dapat positif, nol, atau negatif. Jika units negatif, nanos harus negatif atau nol. Misalnya $-1,75 direpresentasikan sebagai units=-1 dan nanos=-750.000.000.

LogEntry

Entri log individual.

Representasi 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.
}
Kolom
name

string

Wajib. Log tempat entri log ini berada. Contoh: "syslog", "book_log".

timestamp

string (Timestamp format)

Waktu terjadinya peristiwa yang dijelaskan oleh entri log. Jika dihilangkan, setelan defaultnya adalah waktu mulai operasi.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

severity

enum (LogSeverity)

Tingkat keparahan entri log. Nilai defaultnya adalah LogSeverity.DEFAULT.

httpRequest

object (HttpRequest)

Opsional. Informasi tentang permintaan HTTP yang terkait dengan entri log ini, jika berlaku.

trace

string

Opsional. Nama resource trace yang terkait dengan entri log, jika ada. Jika kolom ini berisi nama resource relatif, Anda dapat mengasumsikan bahwa nama tersebut relatif terhadap //tracing.googleapis.com. Contoh: projects/my-projectid/traces/06796866738c859f2f19b7cfb3214824

insertId

string

ID unik untuk entri log yang digunakan untuk penghapusan duplikat. Jika tidak ada, implementasi akan membuatnya berdasarkan operationId.

labels

map (key: string, value: string)

Kumpulan data (kunci, nilai) yang ditentukan pengguna yang memberikan informasi tambahan tentang entri log.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

operation

object (LogEntryOperation)

Opsional. Informasi tentang operasi yang terkait dengan entri log, jika ada.

sourceLocation

object (LogEntrySourceLocation)

Opsional. Informasi lokasi kode sumber yang terkait dengan entri log, jika ada.

Kolom union payload. Payload entri log, yang dapat berupa salah satu dari beberapa jenis. payload hanya ada berupa salah satu diantara berikut:
protoPayload

object

Payload entri log, yang direpresentasikan sebagai buffer protokol yang dinyatakan sebagai objek JSON. Saat ini, satu-satunya jenis yang diterima adalah AuditLog.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

textPayload

string

Payload entri log, direpresentasikan sebagai string Unicode (UTF-8).

structPayload

object (Struct format)

Payload entri log, yang direpresentasikan sebagai struktur yang dinyatakan sebagai objek JSON.

HttpRequest

Proto umum untuk mencatat permintaan HTTP. Hanya berisi semantik yang ditentukan oleh spesifikasi HTTP. Informasi logging khusus produk HARUS ditentukan dalam pesan terpisah.

Representasi 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
}
Kolom
requestMethod

string

Metode permintaan. Contoh: "GET", "HEAD", "PUT", "POST".

requestUrl

string

Skema (http, https), nama host, jalur, dan bagian kueri dari URL yang diminta. Contoh: "http://example.com/some/info?color=red".

requestSize

string (int64 format)

Ukuran pesan permintaan HTTP dalam byte, termasuk header permintaan dan isi permintaan.

status

integer

Kode respons yang menunjukkan status respons. Contoh: 200, 404.

responseSize

string (int64 format)

Ukuran pesan respons HTTP yang dikirim kembali ke klien, dalam byte, termasuk header respons dan isi respons.

userAgent

string

Agen pengguna yang dikirim oleh klien. Contoh: "Mozilla/4.0 (compatible; MSIE 6.0; Windows 98; Q312461; .NET CLR 1.0.3705)".

remoteIp

string

Alamat IP (IPv4 atau IPv6) klien yang menerbitkan permintaan HTTP. Contoh: "192.168.1.1", "FE80::0202:B3FF:FE1E:8329".

serverIp

string

Alamat IP (IPv4 atau IPv6) server asal tempat permintaan dikirim.

referer

string

URL perujuk permintaan, sebagaimana ditentukan dalam Definisi Kolom Header HTTP/1.1.

latency

string (Duration format)

Latensi pemrosesan permintaan di server, dari saat permintaan diterima hingga respons dikirim.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

cacheLookup

boolean

Apakah pencarian cache dicoba atau tidak.

cacheHit

boolean

Apakah suatu entitas disalurkan dari cache (dengan atau tanpa validasi).

cacheValidatedWithOriginServer

boolean

Apakah respons divalidasi dengan server asal sebelum disajikan dari cache atau tidak. Kolom ini hanya bermakna jika cacheHit adalah True.

cacheFillBytes

string (int64 format)

Jumlah byte respons HTTP yang dimasukkan ke dalam cache. Hanya disetel saat pengisian cache dicoba.

protocol

string

Protokol yang digunakan untuk permintaan. Contoh: "HTTP/1.1", "HTTP/2", "websocket"

LogEntryOperation

Informasi tambahan tentang operasi yang berpotensi berjalan lama yang terkait dengan entri log.

Representasi JSON
{
  "id": string,
  "producer": string,
  "first": boolean,
  "last": boolean
}
Kolom
id

string

Opsional. ID operasi arbitrer. Entri log dengan ID yang sama dianggap sebagai bagian dari operasi yang sama.

producer

string

Opsional. ID produser arbitrer. Kombinasi id dan producer harus unik secara global. Contoh untuk producer: "MyDivision.MyBigCompany.com", "github.com/MyProject/MyApplication".

first

boolean

Opsional. Setel ini ke Benar (True) jika ini adalah entri log pertama dalam operasi.

last

boolean

Opsional. Setel ini ke True jika ini adalah entri log terakhir dalam operasi.

LogEntrySourceLocation

Informasi tambahan tentang lokasi kode sumber yang menghasilkan entri log.

Representasi JSON
{
  "file": string,
  "line": string,
  "function": string
}
Kolom
file

string

Opsional. Nama file sumber. Bergantung pada lingkungan runtime, ini bisa berupa nama sederhana atau nama yang sepenuhnya memenuhi syarat.

line

string (int64 format)

Opsional. Baris dalam file sumber. Berbasis 1; 0 menunjukkan tidak ada nomor baris yang tersedia.

function

string

Opsional. Nama fungsi atau metode yang dipanggil yang dapat dibaca manusia, dengan konteks opsional seperti nama class atau paket. Informasi ini dapat digunakan dalam konteks seperti penampil log, yang membuat file dan nomor baris menjadi kurang bermakna. Formatnya dapat bervariasi menurut bahasa. Misalnya: qual.if.ied.Class.method (Java), dir/package.func (Go), function (Python).

QuotaProperties

Mewakili properti yang diperlukan untuk operasi kuota.

Representasi JSON
{
  "quotaMode": enum (QuotaMode)
}
Kolom
quotaMode

enum (QuotaMode)

Mode kuota untuk operasi ini.

ResourceInfo

Menjelaskan resource yang terkait dengan operasi ini.

Representasi JSON
{
  "resourceContainer": string,
  "resourceName": string,
  "resourceLocation": string,
  "permission": string
}
Kolom
resourceContainer

string

ID induk instance resource ini. Harus dalam salah satu format berikut: - projects/<project-id or project-number> - folders/<folder-id> - organizations/<organization-id>

resourceName

string

Nama resource. Ini digunakan untuk tujuan audit.

resourceLocation

string

Lokasi resource. Jika tidak kosong, resource akan diperiksa berdasarkan kebijakan lokasi. Nilai harus berupa zona, region, atau multi-region yang valid. Misalnya: "europe-west4" atau "northamerica-northeast1-a"

permission

string

Izin resource yang diperlukan untuk permintaan ini.

TraceSpan

Rentang mewakili satu operasi dalam rekaman aktivitas. Rentang dapat disusun bertingkat untuk membentuk pohon rekaman aktivitas. Sering kali, rekaman aktivitas berisi rentang root yang menjelaskan latensi end-to-end, dan satu atau beberapa sub-rentang untuk sub-operasinya. Rekaman aktivitas juga dapat berisi beberapa rentang root, atau tidak ada sama sekali. Rentang tidak harus berdekatan—mungkin ada celah atau tumpang-tindih antara rentang dalam rekaman aktivitas.

Representasi 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)
}
Kolom
name

string

Nama resource rentang dalam format berikut:

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

[TRACE_ID] adalah ID unik untuk rekaman aktivitas dalam project; ID ini adalah encoding heksadesimal 32 karakter dari array 16 byte.

[SPAN_ID] adalah ID unik untuk rentang dalam rekaman aktivitas; ID ini adalah encoding heksadesimal 16 karakter dari array 8 byte.

spanId

string

Bagian [SPAN_ID] dari nama resource rentang.

parentSpanId

string

[SPAN_ID] dari rentang induk rentang ini. Jika ini adalah rentang root, kolom ini harus kosong.

displayName

object (TruncatableString)

Deskripsi operasi rentang (hingga 128 byte). Stackdriver Trace menampilkan deskripsi di Google Cloud Platform Console. Misalnya, nama tampilan dapat berupa nama metode yang memenuhi syarat atau nama file dan nomor baris tempat operasi dipanggil. Praktik terbaiknya adalah menggunakan nama tampilan yang sama dalam aplikasi dan di titik panggilan yang sama. Hal ini memudahkan Anda mengorelasikan rentang di berbagai rekaman aktivitas.

startTime

string (Timestamp format)

Waktu mulai rentang. Di sisi klien, ini adalah waktu yang disimpan oleh mesin lokal tempat eksekusi rentang dimulai. Di sisi server, ini adalah waktu saat handler aplikasi server mulai berjalan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Waktu berakhir rentang. Di sisi klien, ini adalah waktu yang disimpan oleh mesin lokal tempat eksekusi rentang berakhir. Di sisi server, ini adalah waktu saat handler aplikasi server berhenti berjalan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

attributes

object (Attributes)

Serangkaian atribut pada rentang. Anda dapat memiliki hingga 32 atribut per rentang.

status

object (Status)

Status akhir opsional untuk rentang ini.

sameProcessAsParentSpan

boolean

(Opsional) Tetapkan parameter ini untuk menunjukkan apakah rentang ini berada dalam proses yang sama dengan induknya. Jika Anda tidak menetapkan parameter ini, Stackdriver Trace tidak dapat memanfaatkan informasi berguna ini.

childSpanCount

integer

Jumlah opsional rentang turunan yang dibuat saat rentang ini aktif. Jika disetel, memungkinkan penerapan mendeteksi rentang turunan yang tidak ada.

spanKind

enum (SpanKind)

Membedakan rentang yang dihasilkan dalam konteks tertentu. Misalnya, dua rentang dengan nama yang sama dapat dibedakan menggunakan CLIENT (pemanggil) dan SERVER (yang dipanggil) untuk mengidentifikasi panggilan RPC.

TruncatableString

Mewakili string yang mungkin dipendekkan ke panjang yang ditentukan.

Representasi JSON
{
  "value": string,
  "truncatedByteCount": integer
}
Kolom
value

string

String yang dipendekkan. Misalnya, jika string asli memiliki panjang 500 byte dan batas string adalah 128 byte, maka value berisi 128 byte pertama dari string 500 byte.

Pemangkasan selalu terjadi pada batas karakter UTF8. Jika ada karakter multi-byte dalam string, panjang string yang dipendekkan mungkin kurang dari batas ukuran.

truncatedByteCount

integer

Jumlah byte yang dihapus dari string asli. Jika nilai ini adalah 0, berarti string tidak dipendek.

Atribut

Kumpulan atribut, masing-masing dalam format [KEY]:[VALUE].

Representasi JSON
{
  "attributeMap": {
    string: {
      object (AttributeValue)
    },
    ...
  },
  "droppedAttributesCount": integer
}
Kolom
attributeMap

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

Kumpulan atribut. Panjang kunci setiap atribut dapat mencapai 128 byte. Nilai dapat berupa string hingga 256 byte, bilangan bulat 64-bit yang telah ditandai, atau nilai Boolean true dan false. Contoh:

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

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

droppedAttributesCount

integer

Jumlah atribut yang dibuang. Atribut dapat dihapus karena kuncinya terlalu panjang atau karena ada terlalu banyak atribut. Jika nilai ini adalah 0, semua atribut valid.

AttributeValue

Jenis yang diizinkan untuk [VALUE] dalam atribut [KEY]:[VALUE].

Representasi 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.
}
Kolom
Kolom union value. Jenis nilai. value hanya ada berupa salah satu diantara berikut:
stringValue

object (TruncatableString)

String dengan panjang hingga 256 byte.

intValue

string (int64 format)

Bilangan bulat 64-bit bertanda.

boolValue

boolean

Nilai Boolean yang diwakili oleh true atau false.