Tüm Ürünler
Search
Belge Merkezi

:GetHistograms

Son Güncelleme:Oct 21, 2026

Belirtilen bir Logstore'da sorgu sözdizimi koşullarını karşılayan günlüklerin dağılımını sorgular.

Operation description

İşlem açıklaması

  • İstek sözdizimindeki Host, proje adından ve Simple Log Service uç noktasından oluşur. Host içinde projeyi belirtmeniz gerekir.

  • Bir AccessKey çifti oluşturulur ve alınır. Daha fazla bilgi için AccessKey çifti konusuna bakın.

Bir Alibaba Cloud hesabının AccessKey çifti, tüm API işlemlerine erişim izinlerine sahiptir ve bu durum yüksek güvenlik riskleri oluşturur. API işlemlerini çağırmak veya rutin O&M işlemlerini gerçekleştirmek için bir Resource Access Management (RAM) kullanıcısı oluşturun ve kullanın. RAM kullanıcısı, İşlem günlükleri gibi Simple Log Service kaynaklarını (EPS kaynağı) yönetme izinlerine sahip olmalıdır. Daha fazla bilgi için RAM kullanıcısı oluşturma ve yetkilendirme konusuna bakın.

  • Günlüklerin ait olduğu projenin adı, bölge ve Logstore adı belirlenir. Daha fazla bilgi için Proje yönetme ve Logstore yönetme konularına bakın.

  • Günlükleri sorgulamadan önce dizinler yapılandırılır. Daha fazla bilgi için Dizin oluşturma konusuna bakın.

  • query parametresi yalnızca sorgu ifadelerini destekler ve analiz ifadelerini desteklemez. Sorgu ifadelerinin ayrıntılı sözdizimi ve sınırlamaları hakkında daha fazla bilgi için Sorguya genel bakış konusuna bakın.

  • Bu işlemin yanıtındaki alt aralık bölme yöntemi her zaman kararlıdır. Sorgu isteğinin zaman aralığı değişmezse, yanıttaki alt aralık bölme sonucu da değişmez.

  • Sorguya dahil olan günlük sayısı çok büyük olduğunda, Simple Log Service API'si tam sonuçları elde etmek için bu işlemin kaç kez çağrılması gerektiğini tahmin edemez. Bu nedenle, nihai tam sonuçları elde etmek için bu işlemi tekrar tekrar çağırıp çağırmayacağınıza karar vermek üzere her isteğin döndürülen sonucundaki ilerleme durumu değerini kontrol edin. Bu işlemin her tekrarlanan çağrısı aynı sayıda sorgu CU'su tüketir.

  • Bir günlüğün Logstore'a yazılmasından GetHistograms veya GetLogs işlemi kullanılarak sorgulanmasına kadar geçen gecikme süresi, yazılan günlük türüne göre değişir. Simple Log Service, günlükleri UNIX zaman damgalarına göre aşağıdaki iki türe ayırır:
    • Gerçek zamanlı veriler: Günlükteki zaman noktası, mevcut sunucu zamanına göre (-180 saniye, 900 saniye] aralığındadır. Örneğin, günlük zamanı UTC 2014-09-25 12:03:00 ise ve sunucu günlüğü UTC 2014-09-25 12:05:00'de alıyorsa, günlük gerçek zamanlı veri olarak işlenir. Gerçek zamanlı verilerin yazılmasından LogSearch arayüzünde sorgulanabilir hale gelmesine kadar geçen gecikme süresi 3 saniyedir.

    • Geçmiş veriler: Günlükteki zaman noktası, mevcut sunucu zamanına göre [-7 × 86400 saniye, -180 saniye) aralığındadır. Örneğin, günlük zamanı UTC 2014-09-25 12:00:00 ise ve sunucu günlüğü UTC 2014-09-25 12:05:00'de alıyorsa, günlük geçmiş veri olarak işlenir. Bu durum genellikle veri geri doldurma senaryolarında ortaya çıkar. Gerçek zamanlı verilerin yazılmasından sorgulanabilir hale gelmesine kadar geçen maksimum gecikme süresi 3 saniyedir. Durumların %99,9'unda sorgu 1 saniye içinde tamamlanır.

Not

Simple Log Service, günlük zamanı (alan adı: __time__) ile sunucu alma zamanı (alan adı: __tag__:__receive_time__) arasındaki farkı hesaplar. Fark (-180 saniye, 900 saniye] aralığındaysa, günlük gerçek zamanlı veridir. Fark [-7 × 86400 saniye, -180 saniye) aralığındaysa, günlük geçmiş veridir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /logstores/{logstore}/index?type=histogram HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

logstore

string

Yes

Logstore adı.

test-logstore

Request parameters

Parameter

Type

Required

Description

Example

project

string

Yes

Projenin adı.

ali-test-project

from

integer

Yes

Alt aralığın başlangıç zamanı. Zaman, 1 Ocak 1970 UTC 00:00:00'den bu yana geçen saniye sayısını temsil eden bir UNIX zaman damgasıdır.

1409529600

to

integer

Yes

Alt aralığın bitiş zamanı. Zaman, 1 Ocak 1970 UTC 00:00:00'den bu yana geçen saniye sayısını temsil eden bir UNIX zaman damgasıdır.

1409569200

topic

string

No

Günlüğün konusu.

topic

query

string

No

Sorgu ifadesi. Yalnızca sorgu ifadeleri desteklenir. Analiz ifadeleri desteklenmez. Sorgu ifadelerinin ayrıntılı sözdizimi ve sınırlamaları hakkında daha fazla bilgi için Sorguya genel bakış konusuna bakın.

with_pack_meta

Response elements

Element

Type

Description

Example

array

İstek parametrelerinin listesi.

object

The request parameters.

from

integer

Alt aralığın başlangıç zamanı. Değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen saniye sayısını temsil eden bir UNIX zaman damgasıdır.\n\nZaman aralığının sol ucu dahil ve sağ ucu hariçtir, yani başlangıç zamanını içerir ancak bitiş zamanını hariç tutar. from ve to değerleri aynıysa aralık geçersizdir ve işlev bir hata döndürür.

1409529600

to

integer

Alt aralığın bitiş zamanı. Değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen saniye sayısını temsil eden bir UNIX zaman damgasıdır.\n\nZaman aralığının sol ucu dahil ve sağ ucu hariçtir, yani başlangıç zamanını içerir ancak bitiş zamanını hariç tutar. from ve to değerleri aynıysa aralık geçersizdir ve işlev bir hata döndürür.

1409569200

count

integer

Alt aralıktaki sorgulanan günlük girişi sayısı.

2

progress

string

Alt aralıktaki sorgu sonucunun tamamlanıp tamamlanmadığını gösterir. Geçerli değerler:\n\n- Complete: Sorgu tamamlanmıştır ve döndürülen sonuç tamdır.\n\n- Incomplete: Sorgu tamamlanmıştır ancak döndürülen sonuç eksiktir. Tam sonucu almak için isteği tekrarlayın.

Complete

Examples

Success response

JSON format

[
  {
    "from": 1409529600,
    "to": 1409569200,
    "count": 2,
    "progress": "Complete"
  }
]

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.