Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Zaplanowane zadania można tworzyć w określonych godzinach lub interwałach przy użyciu rozszerzenia Microsoft Sentinel dla Visual Studio Code. Zadania umożliwiają automatyzację procesów przetwarzania danych w celu podsumowywania, przekształcania lub analizowania danych w jeziorze danych i tabelach federacyjnych usługi Microsoft Sentinel. Zadania są również używane do przetwarzania danych i zapisywania wyników w tabelach niestandardowych w warstwie lake lub warstwie analizy.
Poniższe sekcje wyjaśniają, jak tworzyć, planować, edytować i zarządzać zadaniami notatników, w tym konfigurować harmonogramy zadań, przeglądać szczegóły zadań i historię uruchomień oraz monitorować zadania w portalu Microsoft Defender.
Wymagane uprawnienia dla zadań notatnika
Role Microsoft Entra ID zapewniają szeroki dostęp do wszystkich obszarów roboczych w jeziorze danych. Aby tworzyć i planować zadania, odczytywać tabele we wszystkich obszarach roboczych oraz zapisywać dane do warstw analitycznych i typu lake, musisz mieć jedną z obsługiwanych ról Microsoft Entra ID. Aby uzyskać więcej informacji na temat ról i uprawnień, zobacz Role i uprawnienia w Microsoft Sentinel.
Aby utworzyć nowe tabele niestandardowe w warstwie analitycznej, tożsamość zarządzana usługi Data Lake musi mieć przypisaną rolę Współautor usługi Log Analytics w obszarze roboczym usługi Log Analytics.
Aby przypisać rolę, wykonaj poniższe kroki:
- W witrynie Azure Portal przejdź do obszaru roboczego usługi Log Analytics, któremu chcesz przypisać rolę.
- Wybierz pozycję Kontrola dostępu (IAM) w okienku nawigacji po lewej stronie.
- Wybierz pozycję Dodaj przypisanie roli.
- W tabeli Rola wybierz pozycję Współautor usługi Log Analytics, a następnie wybierz pozycję Dalej
- Wybierz pozycję Tożsamość zarządzana, a następnie wybierz pozycję Wybierz członków.
- Tożsamość zarządzana usługi Data Lake to tożsamość zarządzana przypisana przez system o nazwie
msg-resources-<guid>. Wybierz tożsamość zarządzaną, a następnie wybierz Wybierz. - Wybierz Przejrzyj i przypisz.
Aby uzyskać więcej informacji na temat przypisywania ról do tożsamości zarządzanych, zobacz Przypisywanie ról Azure przy użyciu Azure Portal.
Tworzenie i planowanie zadania
Zanim utworzysz lub zaplanujesz zadanie, upewnij się, że masz jedną z obsługiwanych ról Microsoft Entra ID. Jeśli zadanie tworzy niestandardowe tabele w warstwie analityki, najpierw przypisz tożsamość zarządzanej jeziora danych rolę Log Analytics Contributor. Więcej informacji można znaleźć w artykule Wymagane uprawnienia dla zadań notatników.
Zadanie można utworzyć na jeden z trzech sposobów:
W edytorze notatnika na pasku narzędzi wybierz pozycję Utwórz zaplanowane zadanie.
W okienku Eksplorator kliknij prawym przyciskiem myszy plik notesu i wybierz pozycję Microsoft Sentinel, a następnie wybierz pozycję Utwórz zadanie harmonogramu.
Z listy zadań wybierz ikonę + , aby utworzyć nowe zadanie.
Wybierz pozycję Użyj istniejącego notesu , aby wybrać istniejący plik notesu, lub wybierz pozycję Utwórz nowy notes , aby utworzyć nowy plik notesu dla zadania.
Na stronie Konfiguracja zadania w sekcji Szczegóły zadania wprowadź nazwę i opis zadania.
Wybierz wielkość puli Spark, aby uruchomić zadanie w zależności od wymagań obliczeniowych zadania.
Aby uruchomić zadanie ręcznie bez harmonogramu, wybierz pozycję Na żądanie w sekcji Harmonogram , a następnie wybierz pozycję Prześlij , aby zapisać konfigurację zadania i opublikować zadanie.
Aby określić harmonogram zadania, wybierz pozycję Zaplanowane w sekcji Harmonogram .
Wybierz częstotliwość powtarzania dla zadania. Możesz wybrać opcję Według minuty, godziny, tygodniowego, dziennego lub miesięcznego.
Dodatkowe opcje harmonogramu, takie jak dzień tygodnia, godzina dnia lub dzień miesiąca, są wyświetlane w zależności od wybranej częstotliwości.
Wybierz godzinę Rozpocznij o, od której harmonogram ma zacząć działać.
Wybierz Czas zakończenia, aby harmonogram przestał być uruchamiany. Jeśli nie chcesz ustawiać godziny zakończenia harmonogramu, wybierz pozycję Ustaw zadanie tak, aby było uruchamiane przez czas nieokreślony. Daty i godziny znajdują się w strefie czasowej użytkownika.
Wybierz pozycję Prześlij , aby zapisać konfigurację zadania i opublikować zadanie.
Aby zobaczyć swoje zadania, wybierz
na lewym pasku narzędzi. Zadania są wyświetlane na panelu Zadania .Wybierz zadanie, aby wyświetlić szczegóły zadania.
Zadanie można uruchomić natychmiast, wybierając pozycję Uruchom teraz, wyłącz i włącz harmonogram zadań lub usuń zadanie.
Wyświetl historię zadania na karcie Historia uruchomień.
Wybierz działanie, aby wyświetlić więcej szczegółów.
Tworzenie sparametryzowanych zadań notesu i zarządzanie nimi
Zadania notatnika mogą używać parametrów zdefiniowanych w notatniku. Parametry ułatwiają ponowne użycie tego samego zadania notesu z różnymi wartościami wejściowymi bez konieczności każdorazowego edytowania kodu notesu. Można na przykład uruchomić tę samą analizę dla różnych użytkowników, jednostek, zakresów czasu lub innych danych wejściowych badania.
Sparametryzowane zadania notatnika obsługują trzy poziomy wartości:
- Wartości notesu: domyślne wartości parametrów zdefiniowane w notesie.
- Wartości konfiguracji zadania: wartości zapisane wraz z zadaniem notatnika i używane do zaplanowanych uruchomień.
- Wartości środowiska uruchomieniowego: wartości podane podczas ręcznego uruchamiania zadania. Wartości środowiska uruchomieniowego mają zastosowanie tylko do tego uruchomienia zadania.
Utwórz sparametryzowane zadanie notesu
Podczas tworzenia zadania notatnika z notatnika zawierającego parametry rozszerzenie Microsoft Sentinel odczytuje parametry z notatnika i wyświetla je w konfiguracji zadania.
Aby utworzyć sparametryzowane zadanie notesu:
W notesie utwórz komórkę kodu w górnej części notesu, która zawiera wartości domyślne parametru. Otwórz menu komórki i wybierz pozycję Oznacz komórkę jako Parametry.
Zdefiniuj parametry w komórce. Przykład:
# Parameters lookback_days = [7, 14, 30, 90] min_failed_attempts = [5, 10, 20]W okienku Eksplorator kliknij prawym przyciskiem myszy plik notesu, wybierz pozycję Microsoft Sentinel, a następnie wybierz polecenie Utwórz zaplanowane zadanie.
W edytorze zadań rozwiń węzeł Parametry domyślne, a następnie wybierz pozycję Odśwież parametry , aby załadować najnowsze definicje parametrów z notesu.
Przejrzyj lub zaktualizuj domyślne wartości parametrów, a następnie prześlij zadanie.
Możesz zachować wartości domyślne notesu lub zmienić wartości przed przesłaniem zadania. Wartości, które zmienisz, są zapisywane wraz z konfiguracją zadania i używane podczas przyszłych zaplanowanych uruchomień.
Jeśli wartość parametru nie jest zgodna z oczekiwanym typem, rozszerzenie wyświetla błąd walidacji wbudowanej i uniemożliwia przesłanie zadania do momentu naprawienia błędu.
Dodawanie parametrów do istniejącego zadania notesu
Aby dodać parametry do istniejącego zadania notesu, pobierz najnowszą wersję notesu, zaktualizuj go lokalnie, aby zdefiniować parametry, a następnie edytuj zadanie. Po przesłaniu lub odświeżeniu zaktualizowanego notatnika w konfiguracji zadania parametry są dostępne w zadaniu.
Po udostępnieniu parametrów można zaktualizować ich wartości i ponownie przesłać zadanie. Zaktualizowane wartości parametrów są zapisywane wraz z konfiguracją zadania i używane podczas przyszłych zaplanowanych uruchomień.
Odśwież parametry z notatnika
Jeśli notes zostanie zaktualizowany po utworzeniu zadania, odśwież parametry zadania, aby zsynchronizować konfigurację zadania z najnowszymi parametrami notesu.
Odświeżanie parametrów:
- Dodaje nowe parametry dodane do notesu.
- Usuwa parametry usunięte z notesu.
- Zachowuje istniejące wartości konfiguracji zadania, które zostały zmienione.
Odświeżanie parametrów nie zastępuje wartości parametrów, które zostały już edytowane w konfiguracji zadania.
Resetuj wartości parametrów
Wartości parametrów można zresetować do wartości domyślnych zdefiniowanych w notesie.
Użyj resetowania dla pojedynczego parametru, aby przywrócić tylko daną wartość. Użyj opcji Resetuj wszystko, aby przywrócić wszystkie wartości parametrów do wartości domyślnych notesu. Po zresetowaniu wszystkich wartości parametrów potwierdź zresetowanie przed przywróceniem wartości.
Uruchamianie przy użyciu niestandardowych wartości parametrów środowiska uruchomieniowego
Po wybraniu pozycji Uruchom teraz dla parametryzowanego zadania notesu rozszerzenie Microsoft Sentinel otwiera okno dialogowe parametrów uruchomienia. Okno dialogowe zostaje automatycznie wypełnione wartościami parametrów zapisanymi w konfiguracji zadania.
Możesz zachować zapisane wartości lub zmienić je w bieżącym uruchomieniu. Zmiany parametrów środowiska uruchomieniowego mają zastosowanie tylko do uruchomienia tego zadania i nie aktualizują zapisanej konfiguracji zadania ani przyszłych zaplanowanych przebiegów.
Użyj parametrów środowiska uruchomieniowego, jeśli chcesz ponownie użyć tego samego zadania dla różnych danych wejściowych, takich jak uruchomienie tej samej analizy ryzyka dla innego użytkownika.
Wyświetlanie historii uruchamiania zadania
Po uruchomieniu sparametryzowanego zadania notatnika wyświetl stan zadania i historię uruchomień tak samo jak w przypadku innych uruchomień zadań notatnika. Na karcie Historia uruchomień wybierz uruchomienie, aby wyświetlić więcej szczegółów.
Zadania bez parametrów
Jeśli wybrany notatnik nie definiuje parametrów, konfiguracja zadania pokazuje brak parametrów. Aby dodać parametry, zaktualizuj notesnik tak, aby zawierał definicje parametrów, zapisz notesnik i prześlij lub odśwież konfigurację zadania.
Edytowanie przesłanego zadania
Przesłanie zadania tworzy definicję zadania zawierającą plik notesu, konfigurację zadania i harmonogram. Definicja zadania jest przekazywana z edytora programu VS Code i przechowywana w Microsoft Sentinel data lake. Po przesłaniu zadanie nie jest już połączone z plikiem notesu w lokalnym systemie plików. Jeśli chcesz edytować kod w zadaniu notesu, musisz pobrać definicję zadania, edytować plik notesu, a następnie ponownie przesłać zadanie.
Aby edytować przesłane zadanie, wykonaj poniższe kroki:
W sekcji Zadania wybierz zadanie, które chcesz edytować.
Wybierz ikonę chmury Download, aby pobrać definicję zadania do lokalnego systemu plików. W edytorze szczegółów zadań można zobaczyć konfigurację zadania. Możesz również wybrać pozycję Pobierz najnowszy notatnik.
Edytuj pobrany plik skoroszytu
ipynb, aby wprowadzić zmiany.Wróć do karty Szczegóły zadania i wybierz pozycję Edytuj zadanie.
Edytuj nazwę zadania, opis, konfigurację klastra i harmonogram. Zmiana nazwy zadania powoduje utworzenie nowej definicji zadania podczas przesyłania zadania.
Wybierz pozycję Prześlij , aby przekazać zaktualizowany plik notesu i konfigurację zadania.
Po pomyślnym przesłaniu zadania zostanie wyświetlone potwierdzenie.
Wyświetlanie zadań w portalu Microsoft Defender
Oprócz przeglądania zadań w VS Code możesz również przeglądać zadania notesu w portalu Defender. Aby wyświetlić swoje zadania w portalu usługi Defender, wybierz kolejno Microsoft Sentinel>Data lake exploration>Jobs.
Strona Oferty pracy pokazuje listę stanowisk i ich rodzaje. Wybierz zadanie notatnika, aby wyświetlić jego szczegóły. Możesz włączyć i wyłączyć harmonogram zadania, ale nie możesz edytować zadania notesu w portalu Defender.
Wybierz zadanie, aby wyświetlić szczegóły zadania.
Wybierz pozycję Wyświetl historię , aby wyświetlić historię przebiegów zadań.
Parametry i limity usług
Poniższe sekcje podsumowują zasady nazewnictwa kolumn oraz limity usług dla zadań notebooków w jeziorze danych Microsoft Sentinel.
Wymagania dotyczące nazw kolumn dla metody save_as
Metoda save_as zapisuje wyjście z notatnika do tabeli docelowej w jeziorze danych Microsoft Sentinel. Następujące zasady nazewnictwa kolumn obowiązują przy użyciu tej metody.
Nazwy kolumn muszą zaczynać się literą.
Poniższe kolumny standardowe nie są obsługiwane do eksportowania. Proces ładowania zastępuje następujące kolumny w warstwie docelowej:
- Identyfikator dzierżawy
- _TimeReceived
- Typ
- SourceSystem
- _ResourceId
- _Subscriptionid
- _ItemId
- _BilledSize
- _IsBillable
- _WorkspaceId
TimeGeneratedjest zastępowany, jeśli jest starszy niż dwa dni. Aby zachować oryginalny czas zdarzenia, zapisz sygnaturę czasową źródła w osobnej kolumnie.
Aby uzyskać listę limitów usługi dla jeziora danych Microsoft Sentinel, zobacz Limity usługi jeziora danych Microsoft Sentinel.
Rozwiązywanie problemów
Aby uzyskać informacje na temat rozwiązywania problemów z zadaniami notesów i operacjami w usłudze Data Lake, zobacz Rozwiązywanie problemów z notesami w usłudze Microsoft Sentinel Data Lake.