← Cloudflare Workers / workers / observability

Query Builder

Query Builder vám pomáhá psát strukturované dotazy pro zkoumání a vizualizaci telemetrických dat. Query Builder prohledává dataset Workers Observability, který v současné době zahrnuje všechny logy uložené Workers Logs.

Query Builder najdete v Observabilita stránky Cloudflare dashboardu:

Query Builder je k dispozici všem vývojářům a nevyžaduje žádnou aktivaci. Dotazy prohledávají všechny Workers Logs uložené Cloudflare. Pokud jste Workers Logs ještě neaktivovali, můžete to udělat přidáním následujícího nastavení do Wrangler soubor Workeru a opětovným nasazením Workeru.

{
	"observability": {
		"enabled": true,
		"logs": {
			"invocation_logs": true,
			"head_sampling_rate": 1 // optional. default = 1.
		}
	}
}

[observability]
enabled = true

  [observability.logs]
  invocation_logs = true
  head_sampling_rate = 1

1. V dashboardu Cloudflare přejděte na Workers & Pages stránce.

   Přejděte na Workers & Pages ↗

2. Vyberte svůj Worker.

3. Vyberte Observabilita v levém navigačním panelu a poté Přehled kartě.

4. Vyberte Vizualizace.

5. Volitelné: Přidejte pole do Filter, Group By, Order By a Limit. Další informace najdete v tom, co sestaví dotaz.

6. Volitelné: Vyberte příslušné časové rozmezí.

7. Vyberte Spustit. Dotaz se automaticky spustí při každé provedené změně.

Query Builder podporuje řadu vizualizačních operátorů, včetně:

V jednom dotazu můžete přidat více vizualizací. Každá vizualizace vykreslí graf. Vrací se také jedna souhrnná tabulka, která zobrazuje nezpracované výsledky dotazu.

Všechny metody jsou agregační funkce. Většina metod pracuje s konkrétním polem v log eventu. Count je výjimkou a je agregační funkcí, která vrací počet událostí protokolu odpovídajících podmínkám filtru.

Filtry pomáhají vracet sloupce odpovídající zadaným podmínkám. Filtr má tři složky: klíč, operátor a hodnotu.

Klíčem může být jakékoli pole v události protokolu. Můžete si například zvolit $workers.cpuTimeMs nebo $metadata.message.

Operátor je logická podmínka, která se vyhodnotí jako true nebo false. Podporované podmínky najdete v tabulce níže:

Hodnotou číselného pole je celé číslo. Hodnotou textového pole je libovolný řetězec.

Chcete-li přidat filtr:

Když spustíte dotaz s výše uvedeným filtrem, zobrazí se pouze protokolované události, u kterých $workers.cpuTimeMs > 100 bude vrácen.

Když přidáte více filtrů, zkombinují se pomocí operátoru AND, což znamená, že se vrátí jen události odpovídající všem filtrům.

Search je textový filtr, který vrací pouze události obsahující zadaný text. Search se hodí jako rychlý způsob filtrování nebo pro vyhledávání jedinečných identifikovatelných hodnot ve vašich protokolech.

Group By spojuje řádky se stejnou hodnotou do souhrnných řádků. Pokud dotaz například přidá $workers.event.request.cf.country jako pole Group By, souhrnná tabulka pak seskupí podle země.

Order By ovlivňuje způsob řazení výsledků v souhrnné tabulce. Pokud asc je vybráno, výsledky se řadí vzestupně, od nejmenšího po největší. Pokud desc je vybráno, výsledky se řadí sestupně, od největšího po nejmenší.

Parametr limit omezuje počet vrácených výsledků. V kombinaci s Order By, lze jej použít k vrácení „nejvyšších“ nebo „prvních“ N výsledků.

Výběrem časového rozsahu určíte časový interval, ve kterém chcete vyhledávat odpovídající události. Doba uchovávání závisí na vašem typ plánu.

Pro dotazy existují tři zobrazení: Visualizations, Invocations a Events.

Vizualizace karta zobrazuje grafy a souhrnnou tabulku pro daný dotaz.

Invocations karta zobrazuje všechny protokoly seskupené podle volání a seřazené podle časového razítka. Vracejí se pouze volání odpovídající kritériím dotazu.

Události karta zobrazuje všechny protokoly seřazené podle časového razítka. Vracejí se pouze události odpovídající kritériím dotazu. Kartu Events lze přizpůsobit a přidat do zobrazení další pole.

Doporučuje se ukládat dotazy, které lze znovu použít při budoucím zkoumání. Dotaz můžete uložit s názvem, popisem a vlastními štítky výběrem Save Query. Dotazy se ukládají na úrovni účtu a jsou přístupné všem uživatelům v daném účtu.

Uložené dotazy lze znovu spustit výběrem příslušného dotazu z Dotazy kartě. Dotaz můžete upravit a změny uložit.

Dotazy mohou uživatelé označit hvězdičkou. Označené dotazy patří konkrétnímu uživateli, ne celému účtu.

Uložené dotazy lze odstranit z Dotazy kartě. Pokud dotaz smažete, odstraní se pro všechny uživatele účtu.

1. V dashboardu Cloudflare přejděte na Observabilita stránce.

   Přejděte na Observabilita ↗

2. Vyberte Dotazy kartě.

3. Na pravé straně vyberte tři tečky pro další akce.

4. Vyberte Odstranit dotaz a postupujte podle pokynů.

Uloženým dotazům je přiřazena jedinečná adresa URL, takže je lze sdílet s libovolným uživatelem v účtu.

V tomto příkladu sestavíme dotaz, který najde a pomůže odladit všechny cesty odpovídající chybami 5xx. Nejprve vytvoříme základní dotaz. V tomto základním dotazu chceme vizualizovat podle počtu surových událostí. Můžeme přidat filtr pro $workers.event.response.status která je větší než 500. Poté seskupíme podle $workers.event.request.path a $workers.event.response.status k zjištění počtu požadavků, které toto chování ovlivnilo.

Výsledky ukazují, že /agents/chat/default cestě se vyskytují chyby 404 a 500. Nyní můžeme na tuto cestu použít filtr a prošetřit to.

Nyní to můžeme prozkoumat výběrem Invocations kartě. Vidíme, že tato chyba byla zaznamenána při dvou voláních.

Jedno vyvolání můžete rozbalit a zobrazit související protokoly a pokračovat v ladění.