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.
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.
Simple Log Service, Java SDK'sında GetHistograms kullanımına ilişkin bir örnek sağlar. Daha fazla bilgi için Günlük dağılımını sorgulamak için GetHistograms kullanma konusuna bakın.
Try it now
Test
RAM authorization
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.