Logfire

Połącz Pydantic Logfire, aby agenci mogli odpytywać ślady, logi i metryki, które otrzymuje twój projekt, a jego alerty docierały do Polylane w chwili uruchomienia.

Konfiguracja

Logfire wydaje dostęp do zapytań na kluczu projektu, a dostęp do kanałów powiadomień na kluczu organizacji, więc połączenie jednego projektu wymaga obu. Łącz każdy projekt osobno; klucz organizacji można wykorzystać ponownie dla każdego projektu w organizacji.

Klucz API projektu (wpisywany pierwszy)

1. W Logfire otwórz swój projekt, potem Project settings, potem Security & access, potem New API key
2. Zaznacz Read-only access i Manage project and org, zostaw Key type jako Project, potem Create API key
3. Wklej klucz do Polylane. Region (US lub EU) jest wykrywany z prefiksu klucza, a Polylane pokazuje projekt, do którego klucz należy.

Klucz API organizacji (wpisywany drugi)

1. W Project settings wybierz Go to org settings, potem Security & access, potem New API key
2. Zaznacz Read-only access i Manage project and org, ustaw Key type na Organization, potem Create API key
3. Wklej klucz do Polylane. Polylane sprawdza, czy organizacja klucza jest właścicielem projektu nazwanego przez pierwszy klucz.

Każdy klucz pokazuje w trakcie wklejania, czy Logfire go zaakceptował, a Connect staje się dostępne, gdy oba przejdą. Oba klucze są szyfrowane przed zapisaniem, a agent nigdy ich nie widzi.

Co mogą agenci

• Listować usługi, które raportowały do projektu w oknie czasowym
• Szeregować trasy według liczby żądań, wskaźnika błędów i opóźnień p50/p95
• Przeszukiwać spany i logi według usługi, nazwy spanu, trasy, poziomu, flagi wyjątku lub statusu HTTP
• Otwierać jeden ślad jako drzewo spanów rodzic/dziecko z czasami trwania i komunikatami wyjątków
• Uruchamiać jedną instrukcję SQL tylko do odczytu na tabelach rekordów i metryk, gdy przygotowane narzędzia nie obejmują pytania

Alerty

Przy połączeniu Polylane dodaje się jako kanał powiadomień w projekcie Logfire i dołącza ten kanał do każdego alertu projektu, pozostawiając już skonfigurowane kanały nietknięte. Alerty dodane później są podchwytywane w ciągu godziny. Każdy alert uruchomiony przez Logfire przychodzi jako incydent, który Polylane może zbadać. Odłączenie usuwa kanał i odłącza go od każdego alertu.

Każde zapytanie jest ograniczone do okna czasowego najwyżej siedmiu dni, a ścieżka surowego SQL przyjmuje tylko jedną instrukcję SELECT.

Dlaczego dwa klucze

Klucz projektu obejmuje ślady i metryki, o które pytają agenci: Logfire wydaje ten zakres tylko na kluczu związanym z jednym projektem. Klucz organizacji pozwala Polylane czytać alerty projektu i istniejące kanały powiadomień, tworzyć własny kanał (Logfire trzyma kanały na poziomie organizacji, dlatego klucz projektu nie może tego zrobić) i dołączać go do każdego alertu, aby alert docierał do Polylane w chwili uruchomienia, a incydent mógł otworzyć się wcześnie.

Ciągła weryfikacja

Polylane weryfikuje oba zapisane klucze co sześć godzin i oznacza integrację, gdy Logfire odrzuci którykolwiek klucz albo klucz organizacji nie wymienia już projektu, więc odwołany klucz ujawnia się, zanim będzie potrzebny w dochodzeniu.

Odłączanie

Odłącz Logfire w Polylane, a potem odwołaj w Logfire klucz API projektu w Project settings, potem Security & access, oraz klucz API organizacji w Org settings, potem Security & access. Zachowaj klucz organizacji, jeśli inne projekty organizacji pozostają połączone.