Usar funções nas consultas de log no Azure MonitorUsing functions in Azure Monitor log queries

Para usar uma consulta de log com outra consulta, você pode salvá-la como uma função.To use a log query with another query you can save it as a function. Isso permite que você simplifique consultas complexas, dividindo-os em partes e permite a reutilização de código comum com várias consultas.This allows you to simplify complex queries by breaking them into parts and allows you to reuse common code with multiple queries.

Criar uma funçãoCreate a function

Crie uma função com Log Analytics na portal do Azure clicando em salvar e, em seguida, fornecendo as informações na tabela a seguir.Create a function with Log Analytics in the Azure portal by clicking Save and then providing the information in the following table.

ConfiguraçãoSetting DescriçãoDescription
NomeName Nome de exibição para a consulta no Gerenciador de consultas.Display name for the query in Query explorer.
Salvar comoSave as FunçãoFunction
Alias da funçãoFunction Alias Nome curto para usar a função em outras consultas.Short name to use the function in other queries. Não pode conter espaços e deve ser exclusivo.May not contain spaces and must be unique.
CategoriaCategory Uma categoria para organizar consultas salvas e funções na Explorador de consultas.A category to organize saved queries and functions in Query explorer.

Observação

Uma função no Azure Monitor não pode conter outra função.A function in Azure Monitor cannot contain another function.

Use uma funçãoUse a function

Use uma função, incluindo seu alias em outra consulta.Use a function by including its alias in another query. Pode ser usado como qualquer outra tabela.It can be used like any other table.

ExemploExample

A consulta padrão a seguir retorna todas as atualizações de segurança faltantes relatadas no último dia.The following sample query returns all missing security updates reported in the last day. Salve essa consulta como função com o alias security_updates_last_day.Save this query as a function with the alias security_updates_last_day.

Update
| where TimeGenerated > ago(1d) 
| where Classification == "Security Updates" 
| where UpdateState == "Needed"

Criar outra consulta e referência na função security_updates_last_day ao procurar por atualizações de segurança necessárias relacionadas ao SQL.Create another query and reference the security_updates_last_day function to search for SQL-related needed security updates.

security_updates_last_day | where Title contains "SQL"

Próximas etapasNext steps

Confira outras lições para escrever consultas de log no Azure Monitor:See other lessons for writing Azure Monitor log queries: