[{"data":1,"prerenderedAt":675},["ShallowReactive",2],{"\u002Ffeatures\u002Fsearching-navigation":3,"\u002Ffeatures\u002Fsearching":116},[4,8,28,38,52,56,60,70,74,78,82,86,90,94,98],{"title":5,"path":6,"stem":7},"Get started","\u002Ffeatures","features\u002Findex",{"title":9,"closed":10,"path":11,"stem":12,"children":13,"page":-1},"Traces",true,"\u002Ffeatures\u002Ftraces","features\u002F01.traces\u002Findex",[14,16,20,24],{"title":15,"path":11,"stem":12},"Introduction",{"title":17,"path":18,"stem":19},"Grouping & systems","\u002Ffeatures\u002Ftraces\u002Fgrouping","features\u002F01.traces\u002Fgrouping",{"title":21,"path":22,"stem":23},"Querying spans","\u002Ffeatures\u002Ftraces\u002Fquerying-spans","features\u002F01.traces\u002Fquerying-spans",{"title":25,"path":26,"stem":27},"Querying traces","\u002Ffeatures\u002Ftraces\u002Fquerying-traces","features\u002F01.traces\u002Fquerying-traces",{"title":29,"closed":10,"path":30,"stem":31,"children":32,"page":-1},"Logs","\u002Ffeatures\u002Flogs","features\u002F02.logs\u002Findex",[33,34],{"title":15,"path":30,"stem":31},{"title":35,"path":36,"stem":37},"Grouping rules","\u002Ffeatures\u002Flogs\u002Fgrouping","features\u002F02.logs\u002Fgrouping",{"title":39,"closed":10,"path":40,"stem":41,"children":42,"page":-1},"Metrics","\u002Ffeatures\u002Fmetrics","features\u002F03.metrics\u002Findex",[43,44,48],{"title":15,"path":40,"stem":41},{"title":45,"path":46,"stem":47},"Querying","\u002Ffeatures\u002Fmetrics\u002Fquerying","features\u002F03.metrics\u002F02.querying",{"title":49,"path":50,"stem":51},"PromQL compat","\u002Ffeatures\u002Fmetrics\u002Fpromql-compat","features\u002F03.metrics\u002F03.promql-compat",{"title":53,"path":54,"stem":55},"Alerts and Notifications","\u002Ffeatures\u002Falerting","features\u002F04.alerting",{"title":57,"path":58,"stem":59},"Chart annotations","\u002Ffeatures\u002Fannotations","features\u002F05.annotations",{"title":61,"path":62,"stem":63,"children":64,"closed":10},"Dashboards","\u002Ffeatures\u002Fdashboards","features\u002F06.dashboards\u002F1.index",[65,66],{"title":61,"path":62,"stem":63},{"title":67,"path":68,"stem":69},"YAML Templates","\u002Ffeatures\u002Fdashboards\u002Fyaml","features\u002F06.dashboards\u002F2.yaml",{"title":71,"path":72,"stem":73},"Transformations","\u002Ffeatures\u002Ftransformations","features\u002F07.transformations",{"title":75,"path":76,"stem":77},"Service graph","\u002Ffeatures\u002Fservice-graph","features\u002F08.service-graph",{"title":79,"path":80,"stem":81},"Grafana integration","\u002Ffeatures\u002Fgrafana","features\u002F09.grafana",{"title":83,"path":84,"stem":85},"Data fixtures","\u002Ffeatures\u002Ffixtures","features\u002F10.fixtures",{"title":87,"path":88,"stem":89},"JavaScript Source Maps","\u002Ffeatures\u002Fsourcemaps","features\u002F11.sourcemaps",{"title":91,"path":92,"stem":93},"MCP Server","\u002Ffeatures\u002Fmcp","features\u002F12.mcp",{"title":95,"path":96,"stem":97},"Searching","\u002Ffeatures\u002Fsearching","features\u002F4.searching",{"title":99,"closed":10,"path":100,"stem":101,"children":102,"page":115},"SSO","\u002Ffeatures\u002Fsso","features\u002Fsso",[103,107,111],{"title":104,"path":105,"stem":106},"Google","\u002Ffeatures\u002Fsso\u002Fgoogle","features\u002Fsso\u002F1.google",{"title":108,"path":109,"stem":110},"Okta","\u002Ffeatures\u002Fsso\u002Fokta","features\u002Fsso\u002F2.okta",{"title":112,"path":113,"stem":114},"Keycloak","\u002Ffeatures\u002Fsso\u002Fkeycloak","features\u002Fsso\u002F3.keycloak",false,{"page":117,"surround":670},{"id":118,"title":119,"body":120,"description":658,"extension":659,"image":660,"meta":661,"navigation":667,"path":96,"seo":668,"stem":97,"surround_disabled":115,"__hash__":669},"features\u002Ffeatures\u002F4.searching.md","Searching Spans and Logs",{"type":121,"value":122,"toc":638},"minimark",[123,132,138,143,151,163,173,178,185,193,199,203,214,221,227,231,238,245,251,258,264,268,274,288,292,295,304,317,321,324,328,388,392,399,404,410,413,417,428,432,438,454,458,601,605],[124,125,126,127,131],"p",{},"In addition to the SQL-like ",[128,129,130],"a",{"href":22},"query language",", Uptrace allows you to search spans and logs using a more concise and natural query language that makes finding specific data faster and more intuitive.",[124,133,134],{},[135,136],"img",{"alt":95,"src":137},"\u002Ffeatures\u002Fquerying-spans\u002Fsearching.png",[139,140,142],"h2",{"id":141},"word-filters","Word Filters",[124,144,145,146,150],{},"The simplest query is a single word that must be found within the ",[128,147,149],{"href":148},"#search-scope","search scope",".",[124,152,153,157,158,162],{},[154,155,156],"strong",{},"Example:"," The query ",[159,160,161],"code",{},"error"," will match the following logs:",[164,165,170],"pre",{"className":166,"code":168,"language":169},[167],"language-text","err\nerror\nERROR\nERRor\nan error just occurred\n","text",[159,171,168],{"__ignoreMap":172},"",[174,175,177],"h3",{"id":176},"multiple-words-and-logic","Multiple Words (AND Logic)",[124,179,180,181,184],{},"When your query contains multiple words separated by spaces, ",[154,182,183],{},"all words"," must be found in the search scope.",[124,186,187,157,189,192],{},[154,188,156],{},[159,190,191],{},"error select"," will match:",[164,194,197],{"className":195,"code":196,"language":169},[167],"error select\nselect error\nan error has occurred when executing a select query\n",[159,198,196],{"__ignoreMap":172},[174,200,202],{"id":201},"multiple-words-or-logic","Multiple Words (OR Logic)",[124,204,205,206,209,210,213],{},"To search for logs containing ",[154,207,208],{},"any"," of multiple words, separate them with the pipe character (",[159,211,212],{},"|",").",[124,215,216,157,218,192],{},[154,217,156],{},[159,219,220],{},"select|update",[164,222,225],{"className":223,"code":224,"language":169},[167],"select\nupdate\nselect update\n",[159,226,224],{"__ignoreMap":172},[139,228,230],{"id":229},"phrase-filters","Phrase Filters",[124,232,233,234,237],{},"To search for logs containing an exact phrase, enclose the phrase in double quotes (",[159,235,236],{},"\"","). The phrase can contain any characters, including spaces, punctuation, and special characters.",[124,239,240,157,242,192],{},[154,241,156],{},[159,243,244],{},"\"select query\"",[164,246,249],{"className":247,"code":248,"language":169},[167],"an error has occurred when executing a select query\nselect query\n",[159,250,248],{"__ignoreMap":172},[124,252,253,254,257],{},"But will ",[154,255,256],{},"not"," match:",[164,259,262],{"className":260,"code":261,"language":169},[167],"query select\nselecting a query\n",[159,263,261],{"__ignoreMap":172},[139,265,267],{"id":266},"negative-filters","Negative Filters",[124,269,270,271,213],{},"To exclude logs containing specific words or phrases, prefix the term with a minus sign (",[159,272,273],{},"-",[124,275,276,157,278,281,282,284,285,150],{},[154,277,156],{},[159,279,280],{},"error -ssh"," will find error logs that do ",[154,283,256],{}," contain the word ",[159,286,287],{},"ssh",[174,289,291],{"id":290},"combining-filters","Combining Filters",[124,293,294],{},"You can combine multiple filter types in a single query:",[124,296,297,299,300,303],{},[154,298,156],{}," ",[159,301,302],{},"error \"database connection\" -timeout"," will find logs that:",[305,306,307,311,314],"ul",{},[308,309,310],"li",{},"Contain the word \"error\"",[308,312,313],{},"Contain the exact phrase \"database connection\"",[308,315,316],{},"Do not contain the word \"timeout\"",[139,318,320],{"id":319},"search-scope","Search Scope",[124,322,323],{},"The search scope defines which attributes Uptrace searches when filtering spans and logs. By default, the search scope corresponds to your current grouping expression.",[174,325,327],{"id":326},"default-search-scopes","Default Search Scopes",[329,330,331,343],"table",{},[332,333,334],"thead",{},[335,336,337,341],"tr",{},[338,339,340],"th",{},"Grouping Expression",[338,342,320],{},[344,345,346,359,375],"tbody",{},[335,347,348,354],{},[349,350,351],"td",{},[159,352,353],{},"group by _group_id",[349,355,356],{},[159,357,358],{},"_display_name",[335,360,361,366],{},[349,362,363],{},[159,364,365],{},"group by service_name, host_name",[349,367,368,371,372],{},[159,369,370],{},"service_name",", ",[159,373,374],{},"host_name",[335,376,377,382],{},[349,378,379],{},[159,380,381],{},"group by _group_id, service_name",[349,383,384,371,386],{},[159,385,358],{},[159,387,370],{},[174,389,391],{"id":390},"custom-search-scopes","Custom Search Scopes",[124,393,394,395,398],{},"You can specify custom search scopes for any filter type by using the ",[159,396,397],{},"attribute:value"," syntax:",[124,400,401],{},[154,402,403],{},"Examples:",[164,405,408],{"className":406,"code":407,"language":169},[167],"host_name:host1\nservice_name:\"hello world\"\n",[159,409,407],{"__ignoreMap":172},[124,411,412],{},"This allows you to search specific attributes regardless of your current grouping configuration.",[174,414,416],{"id":415},"searching-indexed-content","Searching Indexed Content",[124,418,419,420,424,425,398],{},"If you have configured a ",[128,421,423],{"href":422},"\u002Ffeatures\u002Ftransformations#text-index","text index transformation"," to index selected attributes, you can search across all indexed content using the ",[159,426,427],{},"*:value",[124,429,430],{},[154,431,403],{},[164,433,436],{"className":434,"code":435,"language":169},[167],"*:hello\n*:error|warning\n-*:debug\n",[159,437,435],{"__ignoreMap":172},[124,439,440,441,444,445,447,448,450,451,453],{},"The ",[159,442,443],{},"*"," scope searches the full-text index built from your selected attributes. Multiple values separated by ",[159,446,212],{}," match if ",[154,449,208],{}," value is found. Prefix with ",[159,452,273],{}," to exclude matching results.",[139,455,457],{"id":456},"filter-syntax-reference","Filter Syntax Reference",[329,459,460,476],{},[332,461,462],{},[335,463,464,467,470,473],{},[338,465,466],{},"Filter Type",[338,468,469],{},"Syntax",[338,471,472],{},"Description",[338,474,475],{},"Example",[344,477,478,495,513,531,549,567,584],{},[335,479,480,483,488,491],{},[349,481,482],{},"Word",[349,484,485],{},[159,486,487],{},"word",[349,489,490],{},"Matches logs containing the word",[349,492,493],{},[159,494,161],{},[335,496,497,500,505,508],{},[349,498,499],{},"Multiple words AND",[349,501,502],{},[159,503,504],{},"word1 word2",[349,506,507],{},"All words must be present",[349,509,510],{},[159,511,512],{},"error database",[335,514,515,518,523,526],{},[349,516,517],{},"Multiple words OR",[349,519,520],{},[159,521,522],{},"word1|word2",[349,524,525],{},"Any word must be present",[349,527,528],{},[159,529,530],{},"error|warning",[335,532,533,536,541,544],{},[349,534,535],{},"Phrase",[349,537,538],{},[159,539,540],{},"\"phrase\"",[349,542,543],{},"Exact phrase match",[349,545,546],{},[159,547,548],{},"\"connection timeout\"",[335,550,551,554,559,562],{},[349,552,553],{},"Negative filter",[349,555,556],{},[159,557,558],{},"-term",[349,560,561],{},"Excludes logs with term",[349,563,564],{},[159,565,566],{},"-debug",[335,568,569,572,576,579],{},[349,570,571],{},"Scoped filter",[349,573,574],{},[159,575,397],{},[349,577,578],{},"Search specific attribute",[349,580,581],{},[159,582,583],{},"host_name:prod-server",[335,585,586,589,593,596],{},[349,587,588],{},"Text index",[349,590,591],{},[159,592,427],{},[349,594,595],{},"Search across all indexed content",[349,597,598],{},[159,599,600],{},"*:hello",[139,602,604],{"id":603},"tips-for-effective-searching","Tips for Effective Searching",[305,606,607,613,626,632],{},[308,608,609,612],{},[154,610,611],{},"Case insensitive",": All text searches are case-insensitive by default",[308,614,615,618,619,622,623,625],{},[154,616,617],{},"Partial matching",": Word filters match partial words (e.g., ",[159,620,621],{},"err"," matches ",[159,624,161],{},")",[308,627,628,631],{},[154,629,630],{},"Combine filters",": Use multiple filter types together for precise results",[308,633,634,637],{},[154,635,636],{},"Use quotes",": Always quote phrases and values containing spaces or special characters",{"title":172,"searchDepth":639,"depth":640,"links":641},4,2,[642,647,648,651,656,657],{"id":141,"depth":640,"text":142,"children":643},[644,646],{"id":176,"depth":645,"text":177},3,{"id":201,"depth":645,"text":202},{"id":229,"depth":640,"text":230},{"id":266,"depth":640,"text":267,"children":649},[650],{"id":290,"depth":645,"text":291},{"id":319,"depth":640,"text":320,"children":652},[653,654,655],{"id":326,"depth":645,"text":327},{"id":390,"depth":645,"text":391},{"id":415,"depth":645,"text":416},{"id":456,"depth":640,"text":457},{"id":603,"depth":640,"text":604},"Search spans and logs using natural syntax with word filters, AND OR pipes, quoted phrases, and scoped field operators.","md",null,{"readingTime":662},{"text":663,"minutes":664,"time":665,"words":666},"3 min read",2.045,122700,409,{"title":95},{"title":119,"description":658},"rvzBhWQeZbZQCIT9t60KEO2OK4zlgJuge1zXQUYekLQ",[671,673],{"title":91,"path":92,"stem":93,"description":672,"children":-1},"Built-in Model Context Protocol (MCP) server that lets AI assistants query spans, traces, metrics, alerts, and dashboards in Uptrace.",{"title":104,"path":105,"stem":106,"description":674,"children":-1},"Configure Google Cloud OpenID Connect SSO with Uptrace using OAuth clients, redirect URIs, and client credentials.",1778588617770]