Mata in data från Splunk Universal Forwarder till Azure Data Explorer
Viktigt
Den här anslutningsappen kan användas i realtidsanalys i Microsoft Fabric. Följ anvisningarna i den här artikeln med följande undantag:
- Om det behövs skapar du databaser med hjälp av anvisningarna i Skapa en KQL-databas.
- Om det behövs skapar du tabeller med hjälp av anvisningarna i Skapa en tom tabell.
- Hämta URI:er för frågor eller inmatning med hjälp av anvisningarna i Kopiera URI.
- Köra frågor i en KQL-frågeuppsättning.
Splunk Universal Forwarder är en förenklad version av Splunk Enterprise-programvaran som gör att du kan mata in data från många källor samtidigt. Den är utformad för att samla in och vidarebefordra loggdata och datordata från olika källor till en central Splunk Enterprise-server eller en Splunk Cloud-distribution. Splunk Universal Forwarder fungerar som en agent som förenklar processen för datainsamling och vidarebefordran, vilket gör den till en viktig komponent i en Splunk-distribution. Azure Data Explorer är en snabb och mycket skalbar datautforskningstjänst för logg- och telemetridata.
I den här artikeln får du lära dig hur du använder Kusto Splunk Universal Forwarder Connector för att skicka data till en tabell i klustret. Du skapar först en tabell och datamappning, sedan dirigerar du Splunk för att skicka data till tabellen och validerar sedan resultatet.
Förutsättningar
- Splunk Universal Forwarder har laddats ned på samma dator där loggarna kommer.
- Ett Azure Data Explorer-kluster och en databas. Skapa ett kluster och en databas.
- Docker installerat på systemet som kör Kusto Splunk Universal Forwarder-anslutningsprogrammet.
- Ett Microsoft Entra tjänstens huvudnamn. Skapa ett Microsoft Entra tjänstens huvudnamn.
Skapa en Azure Data Explorer-tabell
Skapa en tabell för att ta emot data från Splunk Universal Forwarder och ge sedan tjänstens huvudnamn åtkomst till den här tabellen.
I följande steg skapar du en tabell med namnet SplunkUFLogs
med en enda kolumn (RawText
). Det beror på att Splunk Universal Forwarder som standard skickar data i ett rådataformat. Följande kommandon kan köras i frågeredigeraren för webbgränssnittet.
Skapa en tabell:
.create table SplunkUFLogs (RawText: string)
Kontrollera att tabellen
SplunkUFLogs
har skapats och är tom:SplunkUFLogs | count
Använd tjänstens huvudnamn från Förutsättningar för att bevilja behörighet att arbeta med databasen som innehåller din tabell.
.add database YOUR_DATABASE_NAME admins ('aadapp=YOUR_APP_ID;YOUR_TENANT_ID') 'Entra service principal: Splunk UF'
Konfigurera Splunk Universal Forwarder
När du laddar ned Splunk Universal Forwarder öppnas en guide för att konfigurera vidarebefordraren.
I guiden ställer du in Den mottagande indexeraren så att den pekar på det system som är värd för Kusto Splunk Universal Forwarder-anslutningsprogrammet. Ange
127.0.0.1
för värdnamnet eller IP-adressen och9997
för porten. Lämna målindexeraren tom.Mer information finns i Aktivera en mottagare för Splunk Enterprise.
Gå till mappen där Splunk Universal Forwarder är installerad och sedan till mappen /etc/system/local . Skapa eller ändra filen inputs.conf så att vidarebefordraren kan läsa loggar:
[default] index = default disabled = false [monitor://C:\Program Files\Splunk\var\log\splunk\modinput_eventgen.log*] sourcetype = modinput_eventgen
Mer information finns i Övervaka filer och kataloger med inputs.conf.
Gå till mappen där Splunk Universal Forwarder är installerad och sedan till mappen /etc/system/local . Skapa eller ändra filen outputs.conf för att fastställa målplatsen för loggarna, vilket är värdnamnet och porten för det system som är värd för Kusto Splunk Universal Forwarder-anslutningsprogrammet:
[tcpout] defaultGroup = default-autolb-group sendCookedData = false [tcpout:default-autolb-group] server = 127.0.0.1:9997 [tcpout-server://127.0.0.1:9997]
Mer information finns i Konfigurera vidarebefordran med outputs.conf.
Starta om Splunk Universal Forwarder.
Konfigurera Kusto Splunk Universal-anslutningsappen
Så här konfigurerar du Kusto Splunk Universal-anslutningsappen för att skicka loggar till din Azure Data Explorer-tabell:
Ladda ned eller klona anslutningsappen från GitHub-lagringsplatsen.
Gå till baskatalogen för anslutningsappen:
cd .\SplunkADXForwarder\
Redigera config.yml så att den innehåller följande egenskaper:
ingest_url: <ingest_url> client_id: <ms_entra_app_client_id> client_secret: <ms_entra_app_client_secret> authority: <ms_entra_authority> database_name: <database_name> table_name: <table_name> table_mapping_name: <table_mapping_name> data_format: csv
Fält Beskrivning ingest_url
Inmatnings-URL:en för ditt Azure Data Explorer-kluster. Du hittar den i Azure Portal under URI för datainmatning på fliken Översikt i klustret. Versionsformatet ska vara https://ingest-<clusterName>.<region>.kusto.windows.net
.client_id
Klient-ID:t för din Microsoft Entra programregistrering som skapades i avsnittet Förutsättningar. client_secret
Klienthemligheten för din Microsoft Entra programregistrering som skapades i avsnittet Förutsättningar. authority
ID:t för den klientorganisation som innehåller din Microsoft Entra programregistrering som skapades i avsnittet Förutsättningar. database_name
Namnet på din Azure Data Explorer-databas. table_name
Namnet på din Azure Data Explorer-måltabell. table_mapping_name
Namnet på datamappningen för inmatning för tabellen. Om du inte har någon mappning kan du utelämna den här egenskapen från konfigurationsfilen. Du kan alltid parsa data i olika kolumner senare. data_format
Det förväntade dataformatet för inkommande data. Inkommande data är i rådataformat, så det rekommenderade formatet är csv
, som mappar rådatatexten till nollindexet som standard.Skapa Docker-avbildningen:
docker build -t splunk-forwarder-listener
Kör Docker-containern:
docker run -p 9997:9997 splunk-forwarder-listener
Kontrollera att data matas in i Azure Data Explorer
När Docker körs skickas data till din Azure Data Explorer-tabell. Du kan kontrollera att data matas in genom att köra en fråga i frågeredigeraren för webbgränssnittet.
Kör följande fråga för att kontrollera att data matas in i tabellen:
SplunkUFLogs | count
Kör följande fråga för att visa data:
SplunkUFLogs | take 100