Functies in Azure Monitor-logboekquery's

Een functie is een logboekquery in Azure Monitor die kan worden gebruikt in andere logboekquery's alsof het een opdracht is. Met Functions kunnen ontwikkelaars oplossingen bieden aan verschillende klanten en kunt u querylogica opnieuw gebruiken in uw eigen omgeving. Dit artikel bevat informatie over het gebruik van functies en het maken van uw eigen functies.

Typen functies

Er zijn twee typen functies in Azure Monitor:

  • Oplossingsfunctie: Vooraf gebouwde functies die zijn opgenomen in Azure Monitor. Deze zijn beschikbaar in alle Log Analytics-werkruimten en kunnen niet worden gewijzigd.
  • Werkruimtefuncties: Functies die zijn geïnstalleerd in een bepaalde Log Analytics-werkruimte en kunnen worden gewijzigd en beheerd door de gebruiker.

Functies weergeven

U kunt oplossingsfuncties en werkruimtefuncties in de huidige werkruimte bekijken op het tabblad Functies in het linkerdeelvenster van een Log Analytics-werkruimte. Gebruik de knop Filter om de functies in de lijst en Groeperen te filteren om de groepering te wijzigen. Typ een tekenreeks in het zoekvak om een bepaalde functie te zoeken. Beweeg de muisaanwijzer over een functie om details over deze functie weer te geven, inclusief een beschrijving en parameters.

View function

Een functie gebruiken

Gebruik een functie in een query door de naam ervan te typen met waarden voor parameters, net zoals u in een opdracht zou typen. De uitvoer van de functie kan worden geretourneerd als resultaten of doorgesluisd naar een andere opdracht.

Voeg een functie toe aan de huidige query door te dubbelklikken op de naam of de muisaanwijzer erop te bewegen en Use in editor te selecteren. Functies in de werkruimte worden ook opgenomen in intellisense terwijl u een query typt.

Als voor een query parameters zijn vereist, geeft u deze op met behulp van de syntaxis: function_name(param1,param2,...).

Use a function

Een functie maken

Als u een functie wilt maken op basis van de huidige query in de editor, selecteert u Opslaan en vervolgens opslaan als functie.

Create a function

Maak een functie met Log Analytics in de Azure Portal door op Opslaan te klikken en vervolgens de informatie op te geven in de volgende tabel.

Instelling Beschrijving
Functienaam Naam voor de functie. Dit mag geen spatie of speciale tekens bevatten. Het mag ook niet beginnen met een onderstrepingsteken (_), omdat dit teken is gereserveerd voor oplossingsfuncties.
Verouderde categorie Door de gebruiker gedefinieerde categorie om filter- en groepsfuncties te helpen.
Opslaan als computergroep Sla de query op als computergroep.
Parameters Voeg een parameter toe voor elke variabele in de functie waarvoor een waarde is vereist wanneer deze wordt gebruikt. Zie Functieparameters voor meer informatie.

Function details

Functieparameters

U kunt parameters toevoegen aan een functie, zodat u waarden kunt opgeven voor bepaalde variabelen wanneer u deze aanroept. Hierdoor kan dezelfde functie worden gebruikt in verschillende query's, elk met verschillende waarden voor de parameters. Parameters worden gedefinieerd door de volgende eigenschappen.

Instelling Beschrijving
Type Gegevenstype voor de waarde.
Naam Naam voor de parameter. Dit is de naam die moet worden gebruikt in de query om te vervangen door de parameterwaarde.
Standaardwaarde De waarde die moet worden gebruikt voor de parameter als er geen waarde wordt opgegeven.

Parameters worden geordend omdat ze worden gemaakt met parameters die geen standaardwaarde hebben die vóór de parameters met een standaardwaarde staan.

Werken met functiecode

U kunt de code van een functie bekijken om inzicht te krijgen in hoe deze werkt of om de code voor een werkruimtefunctie te wijzigen. Selecteer De functiecode laden om de functiecode toe te voegen aan de huidige query in de editor. Als u deze toevoegt aan een lege query of de eerste regel van een bestaande query, wordt de functienaam toegevoegd aan het tabblad. Als het een werkruimtefunctie is, kunt u hiermee de functiedetails bewerken.

Load function code

Een functie bewerken

Bewerk de eigenschappen of de code van een functie door een nieuwe query te maken en plaats de muisaanwijzer op de naam van de functie en selecteer de functiecode. Breng de gewenste wijzigingen aan in de code en selecteer Opslaan en vervolgens functiedetails bewerken. Breng de eigenschappen en parameters van de functie aan voordat u op Opslaan klikt.

Edit function

Voorbeeld

De volgende voorbeeldfunctie retourneert alle gebeurtenissen in het Azure-activiteitenlogboek sinds een bepaalde datum en die overeenkomen met een bepaalde categorie.

Begin met de volgende query met behulp van vastgelegde waarden. Hiermee wordt gecontroleerd of de query werkt zoals verwacht.

AzureActivity
| where CategoryValue == "Administrative"
| where TimeGenerated > todatetime("2021/04/05 5:40:01.032 PM")

Example function - initial query

Vervang vervolgens de vastgelegde waarden door parameternamen en sla de functie op door Opslaan en vervolgens Opslaan als te selecteren.

AzureActivity
| where CategoryValue == CategoryParam
| where TimeGenerated > DateParam

Example function - save function

Geef de volgende waarden op voor de functie-eigenschappen.

Eigenschap Waarde
Functienaam AzureActivityByCategory
Verouderde categorie Demofuncties

Definieer de volgende parameters voordat u de functie opslaat.

Type Naam Standaardwaarde
tekenreeks CategoryParam "Administratief"
datum/tijd DateParam

Example function - function properties

Maak een nieuwe query en bekijk de nieuwe functie door de muisaanwijzer erop te bewegen. Noteer de volgorde van de parameters omdat dit de volgorde is die ze moeten worden opgegeven wanneer u de functie gebruikt.

Example function - view details

Selecteer Use in editor om de nieuwe functie toe te voegen aan een query en vervolgens waarden voor de parameters toe te voegen. Houd er rekening mee dat u geen waarde hoeft op te geven voor CategoryParam omdat deze een standaardwaarde heeft.

Example function - use function

Volgende stappen

Bekijk andere lessen voor het schrijven van Azure Monitor-logboekquery's: