DescribeHistoryMonitorValues - - Alibaba Cloud Dokümantasyon Merkezi

Operation description

Bu API'ye karşılık gelen konsol işlemi için Performans izleme bölümüne bakın.

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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

kvstore:DescribeHistoryMonitorValues

get

*DBInstance

acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}

kvstore:ResourceTag
kvstore:ResourceTag
kvstore:ResourceTag
kvstore:ResourceTag

None

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	Örnek kimliği.	r-bp1zxszhcgatnx******
StartTime	string	Yes	Geçmiş izleme verileri için sorgunun başlangıç zamanı. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde (UTC) belirtin.	2022-11-06T00:00:00Z
EndTime	string	Yes	Geçmiş izleme verileri için sorgunun bitiş zamanı. Bitiş zamanı, başlangıç zamanından sonra olmalıdır. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde (UTC) belirtin. Not Son bir aya ait izleme verilerini sorgulayabilirsiniz ve maksimum sorgu aralığı 7 günü aşamaz.	2022-11-06T00:30:00Z
IntervalForHistory	string	Yes	[Kullanımdan Kaldırıldı] Bu parametre kullanımdan kaldırılmıştır ve sabit bir `01m` değerine sahiptir. Sistem, başlangıç ve bitiş zamanına göre sorgu aralığını otomatik olarak belirler. Örneğin, sorgu zaman aralığı 10 dakikadan küçük veya buna eşitse, veri toplama sıklığı 5 saniyedir ve sorgu sonuçları 5 saniyelik sıklıkla döndürülür. Not Sorgu sonuçları, örneğin veri toplama sıklığı ile hizalanır. Belirttiğiniz StartTime bir veri toplama zaman noktasına denk gelmiyorsa, sistem tarafından döndürülen ilk zaman noktası en yakın veri toplama zaman noktasıdır. Örneğin, belirttiğiniz StartTime 2022-01-20T12:01:48Z ise, sistem tarafından döndürülen ilk zaman noktası 2022-01-20T12:01:45Z olur. Örneğin veri parçası sayısı 32'den büyük veya buna eşitse, minimum veri toplama sıklığı 1 dakikadır.	01m
MonitorKeys	string	No	İzleme metrikleri. Birden fazla izleme metriği belirtmek için bunları virgülle (,) ayırın. CpuUsage örneğini ele alalım: Küme veya okuma/yazma bölme mimarisi: Tüm veri düğümlerinin (DB) genel CPU kullanımını sorgulamak için CpuUsage$db belirtin. Tek bir veri düğümünün CPU kullanımını sorgulamak için CpuUsage belirtin ve NodeId parametresini DB düğümüne ayarlayın. Standart mimari (birincil/ikincil): CpuUsage belirtin. Daha fazla izleme metriği ve ayrıntılı açıklamalar için MonitorKeys parametre açıklaması bölümüne bakın. Not Varsayılan değer boştur ve UsedMemory ile quotaMemory metriklerini döndürür. Sorgu verimliliğini sağlamak için, tek bir düğüm için izleme metriklerini sorgularken istek başına en fazla 5 izleme metriği belirtin. Toplu izleme metriklerini sorgularken istek başına en fazla 1 izleme metriği belirtin.	CpuUsage
NodeId	string	No	Örnekteki düğüm kimliği. Belirli bir düğümün izleme bilgilerini sorgulamak için bu parametreyi belirtin. Not Bu parametre yalnızca örnek mimarisi okuma/yazma bölme veya küme olduğunda kullanılabilir. Düğüm kimliklerini sorgulamak için DescribeLogicInstanceTopology işlemini çağırın.	r-bp1zxszhcgatnx**-db-0#1679**
NodeRole	string	No	Bulut yerlisi okuma/yazma bölme mimarisi örneğindeki salt okunur düğümlerin metriklerini sorgulamak için belirli NodeId değerini belirtin ve bu parametreyi READONLY olarak ayarlayın. Not Diğer durumlarda bu parametreyi belirtmenize gerek yoktur (veya MASTER olarak belirtin).	READONLY
Type	string	No

MonitorKeys parametre açıklaması

OpenAPI'yi çağırırken aşağıdaki tabloda MonitorKeys sütunundaki parametreleri belirtin. Sistem alt metrikleri döndürür. Örnekler genel izleme metriklerini ve komut istatistikleri izleme metriklerini destekler.

Genel izleme metrikleri

Aşağıda genel izleme metriklerinin nasıl kullanılacağı açıklanmaktadır. CpuUsage örneğini kullanarak:

Küme veya okuma/yazma bölme mimarisi:
- Tüm veri düğümlerinin (DB) genel CPU kullanımını sorgulamak için: CpuUsage$db değerini belirtin.
- Tüm Proxy düğümlerinin genel CPU kullanımını sorgulamak için: CpuUsage$proxy değerini belirtin.
- Tek bir veri düğümünün veya Proxy düğümünün CPU kullanımını sorgulamak için: CpuUsage değerini belirtin ve NodeId parametresini DB düğümü veya Proxy düğümü olarak ayarlayın.
Standart mimari (birincil/ikincil): CpuUsage değerini belirtin.

MonitorKeys	Alt metrik	Birim	Açıklama	Desteklenen kapsam
CpuUsage	CpuUsage	%	CPU kullanımı. Değer aralığı: 0 ile 100 arası. Not Örneğiniz daha önce RedisCpuUsage parametresini kullandıysa veya döndürdüyse, orijinal parametreyi kullanmaya devam edebilirsiniz.	DB DB toplaması Proxy Proxy toplaması
MemoryUsage	memoryUsage	%	Bellek kullanımı.	DB DB toplaması
quotaMemory	quotaMemory	Bayt	Geçerli parçanın toplam belleği.	DB DB toplaması
UsedMemory	UsedMemory	Bayt	Veri ve önbellek dahil kullanılan bellek.	DB DB toplaması
Tair_PmemUsage	PmemUsage	%	Sırasıyla kalıcı bellek kullanımı, kullanılan kalıcı bellek ve toplam kalıcı bellek. Yalnızca kalıcı bellek için optimize edilmiş örnekler bu metriği destekler.	DB DB toplaması
Tair_Pmem	PmemUsed	Bayt
Tair_Pmem	PmemQuota	Bayt
Redis_DetailedSpaceUsage	ins_size	MB	Sırasıyla toplam örnek depolama alanı, veri dosyaları (AOF ve RDB dosyaları dahil) tarafından kullanılan disk alanı ve günlük dosyaları (işlem günlükleri dahil) tarafından kullanılan disk alanı. Yalnızca klasik dağıtım modundaki (eski adıyla yerel disk) bellek için optimize edilmiş örnekler bu metriği destekler.	DB DB toplaması
	data_size	MB
	log_size	MB
Redis_Memory_Monitor	used_memory_rss	Bayt	İşlem tarafından kullanılan fiziksel bellek; bu, işletim sistemi tarafından Tair hizmetine ayrılan bellektir.	DB
	used_memory_lua	Bayt	Lua betikleri tarafından kullanılan bellek.
	used_memory_startup	Bayt	Tair başlatıldığında tüketilen bellek.
	lazyfree_pending_objects	Sayı	Tair lazy free işlemleri sırasında gerçek bellek geri kazanımı için bekleyen anahtar sayısı.
	used_memory_overhead	Bayt	Tair'in tüm istemcilerin çıkış arabellekleri, sorgu arabellekleri ve AOF dahil olmak üzere veri kümesinin dahili mekanizmalarını sürdürmek için ihtiyaç duyduğu bellek ek yükü.
	used_memory_dataset	Bayt	Veri tarafından kullanılan bellek alanı.
CustomerMemoryUsage	CustomerMemoryUsage	%	Kullanıcı bellek kullanımı. Değer aralığı: 0 ile 100 arası.	DB DB toplaması
UsedQPS	TotalQps	Sayı/s	Okuma ve yazma komutları dahil saniye başına toplam istek sayısı.	DB DB toplaması Proxy Proxy toplaması
	GetQps	Sayı/s	Sırasıyla saniye başına okuma ve yazma komutu istekleri sayısı. Örneğin uyumlu sürümü Redis 4.0 veya sonraki bir sürüm olmalıdır.
	PutQps	Sayı/s
	OtherOps	Sayı/s	PING, INFO, SELECT ve AUTH gibi okuma veya yazma öznitelikleri olmayan istekler. Proxy, istekler üzerinde özel işlemler gerçekleştirdiğinden, örnekte Proxy düğümleri varsa OtherOps yalnızca bazı INFO isteklerini içerir.
ConnectionUsage	connectionUsage	%	Bağlantı kullanımı. Hesaplama yöntemi: kullanılan bağlantı sayısı ÷ örnek tarafından desteklenen toplam bağlantı sayısı. Bu metrik, istemciler bir örneğine (küme mimarisi) doğrudan bağlantı adresi üzerinden bağlandığında kullanışlıdır.	DB DB toplaması
UsedConnection	ConnCount	Sayı	Kullanılan bağlantı sayısı.	DB DB toplaması
IntranetIn	InFlow	KB/s	Gelen ve giden trafik hızları.	DB DB toplaması Proxy Proxy toplaması
IntranetOut	OutFlow	KB/s	Gelen ve giden trafik hızları.	DB DB toplaması Proxy Proxy toplaması
IntranetInRatio	intranetInRatio	%	Gelen ve giden trafik kullanımı.	DB DB toplaması
IntranetOutRatio	intranetOutRatio	%	Gelen ve giden trafik kullanımı.	DB DB toplaması
Redis_Avg_Rt_Monitor	AvgRt	us	Arka uç düğümünün bir komutu aldığı andan yanıtı gönderdiği ana kadar geçen ortalama süreyi belirten ortalama gecikme. DB düğümleri için metrik, Proxy ve yük dengeleme tarafından tüketilen süreyi içermez. Proxy düğümleri için metrik, DB ve Proxy tarafından tüketilen süreyi içerir, ancak yük dengeleme tarafından tüketilen süreyi içer

Response elements

Element	Type	Description	Example
	object
MonitorHistory	string	JSON biçiminde döndürülen izleme bilgileri. Daha fazla bilgi için İzleme parametresi açıklaması bölümüne bakın. Not Veri iletim verimliliğini artırmak için yalnızca sıfır olmayan izleme verileri döndürülür. Görüntülenmeyen diğer tüm izleme verilerinin varsayılan değeri 0'dır.	"{\"2022-11-06T00:00:00Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:05Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:10Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:15Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:20Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:25Z\":{\"memoryUsage\":\"6.67\"}}"
RequestId	string	İstek kimliği.	F0997EE8-F4C2-4503-9168-85177ED7****
MonitorLegend	string

Examples

Success response

JSON format

{
  "MonitorHistory": "\"{\\\"2022-11-06T00:00:00Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:05Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:10Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:15Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:20Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:25Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"}}\"",
  "RequestId": "F0997EE8-F4C2-4503-9168-85177ED7****",
  "MonitorLegend": ""
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidStartTime.Malformed	The Specified parameter "StartTime" is not valid.
400	InvalidEndTime.Malformed	The Specified parameter "EndTime" is not valid.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.