Dokumentacja dla programistów
Dzienniki audytu
Dokumentacja API (rdzeń)Dokumentacja API
Dzienniki audytu w monday.com zawierają szczegółowy zapis działań związanych z bezpieczeństwem konta, takich jak próby logowania, eksporty danych z tablic i inne. Dostęp do tych dzienników mają wyłącznie administratorzy konta korzystający z planu Enterprise.
Zapytania
Pobieranie dzienników audytu
- 🚧 Dostępne tylko w planie Enterprise
- Wymagane uprawnienia:
manage_account_security - Zwraca obiekt zawierający metadane dzienników audytu
- Można wysłać je tylko bezpośrednio na poziomie głównym; nie można zagnieżdżać go w innym zapytaniu
query {
audit_logs(
user_id: 1234567890
events: [
"login"
"logout"
]
limit: 100
) {
logs {
timestamp
event
user_agent
user {
id
name
email
}
ip_address
}
pagination {
has_more_pages
next_page_number
}
}
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken, apiVersion: "2025-07" });
const query = `query ($userId: ID!, $events: [String!]) { audit_logs(user_id: $userId, events: $events, limit: 100) { logs { timestamp event user_agent user { id name email } ip_address } pagination { has_more_pages next_page_number } } }`
const variables = {
userId: 1234567890,
events: ["login", "logout"]
}
const response = await mondayApiClient.request(query, variables);
Argumenty
| Argument | Typ | Opis |
|---|---|---|
| end_time | ISO8601DateTime |
Filtruje dzienniki do tej daty i godziny włącznie. |
| events | [String!] |
Konkretne zdarzenie lub zdarzenia, dla których mają zostać zwrócone dzienniki. Listę obsługiwanych zdarzeń możesz wyświetlić, wysyłając zapytanie o obiekt audit_event_catalogue. |
| ip_address | String |
Adres IP, dla którego mają zostać zwrócone dzienniki. |
| limit | Int |
Liczba dzienników na stronę. |
| page | Int |
Numer strony do pobrania. Numeracja zaczyna się od 1. |
| start_time | ISO8601DateTime |
Filtruje dzienniki od tej daty i godziny. |
| user_id | ID |
Użytkownik, dla którego mają zostać zwrócone dzienniki. Jego ID możesz pobrać, wysyłając zapytanie o users. |
Pola
| Pole | Typ | Opis |
|---|---|---|
| logs | [AuditLogEntry!] |
Stronicowana lista wpisów dziennika audytu. |
| pagination | Pagination |
Informacje o stronicowaniu obiektu. |