Połącz dzienniki kontenera Docker z Claude za pomocą MCP

Dzienniki konteneroweBezpłatny planStrumienie zapytańKlaudiusz

Dzienniki kontenerów → Claude · z Query Streams

Dzięki Query Streams możesz zadawać Claude pytania po polsku o plik dzienników kontenerów: Agent działający już w Twojej sieci wykonuje zapytania SQL tylko do odczytu, a hasło do bazy danych nigdy nie trafia do AI. Konfiguracja zajmuje około dziesięciu minut, a bezpłatny plan w zupełności wystarczy.

Zacznij za darmo

Co z tego wyjdzie?

Claude, który może odpowiadać na pytania dotyczące logów kontenera Docker za pomocą zapytań na żywo, tylko do odczytu, na tabelach tworzonych przez Agenta z Twoich plików, i informować, z którego pliku pochodzi każda odpowiedź — bez konieczności sprawdzania loginu ani ścieżki dostępu i bez zmiany zapory sieciowej: Agent, który jest już w Twojej sieci, odczytuje folder i odsyła tylko wiersze. Po uruchomieniu Agenta połączenie z Claude zajmuje około 90 sekund, jeśli nie przeszkadza Ci ekran ustawień. Na przykład:

Claude · połączony z Query Streams Tylko do odczytu

Które kontenery zapisały błędy do stderr w ciągu ostatniej godziny?

qs_get_table_schema qs_run_query inteligencja_schematu

Claude czyta kolumny zestaw_plików.zdarzenia najpierw. Następnie uruchamia jedno zapytanie, które zachowuje wiersze, gdzie strumień Jest stderr oraz czas_wydarzenia przypada na ostatnią godzinę, od najnowszych. Na szczególną uwagę zasługują trzy kontenery:

aplikacja	strumień	wiadomość
API kasy	stderr	BŁĄD wybierz tcp 172.18.0.4:5432: połącz: połączenie odrzucone
pracownik	stderr	redis.exceptions.TimeoutError: Przekroczono limit czasu odczytu z gniazda
serwer proxy nginx	stderr	[błąd] 29#29: *1184 przekroczono limit czasu połączenia (110: przekroczono limit czasu połączenia)

Interfejs API checkout-api utracił bazę danych, a serwer proxy przekroczył limit czasu oczekiwania na połączenie z serwerem. Poproś Claude'a o zliczenie wierszy stderr na kontener na minutę, aby sprawdzić, który z nich padł pierwszy. Odpowiedź dotyczy danych odczytanych przez agenta podczas ostatniego skanowania.

Czy błąd połączenia checkout-api jest nowy i co jeszcze działo się w tym samym czasie?

qs_run_query qs_run_query

policzyłem API kasy błędy stderr na godzinę w zestaw_plików.zdarzeniai umieść postgres oraz harmonogram kontenery obok siebie na te same godziny:

Godzina	błędy interfejsu API kasy	postgres restartuje się	ostrzeżenia harmonogramu
12:00	0	0	0
13:00	412	1	9
14:00	1,880	2	31

Nowość od 13:07 i nie jest to wina checkout-api: każdy pakiet zaczyna się od minuty postgres restarty i ostatnie linie programu Postgres przed każdym restartem to brak pamięci. Napraw limit pamięci kontenera bazy danych i związane z nim błędy pobierania.

Tylko SELECT, sprawdzane przez Agenta zalogowano na karcie Aktywność MCP Zwrócono 6 wierszy w 3 zapytaniach

A może w ogóle nie podłączać klienta AI? W planie biznesowym Nova to asystent wbudowany w Query Streams. Korzysta z tego samego zestawu narzędzi agenta, co Twój klient AI, a dodatkowo z tego, czego nie robi klient zewnętrzny: tworzy i weryfikuje kod SQL w oparciu o model inteligencji semantycznej, przekształca odpowiedź w wykres i zapisuje wynik jako zapytanie, które Twój zespół może uruchomić z poziomu Excela, Arkuszy Google lub interfejsu REST API — bez klucza, bez konektora i bez instalacji. Użyj MCP, gdy Twoi pracownicy korzystają już z Claude, Cursor lub ChatGPT; użyj Nova, gdy chcesz uzyskać odpowiedzi w Portalu.

Container Logs odczytuje pliki dziennika zapisywane przez Dockera dla każdego kontenera i przekształca każdy wiersz w wiersz w tabeli SQL, którą Claude może przeszukać. Nie jest to własny zestaw narzędzi MCP Dockera. Nie uruchamia ani nie zarządza kontenerami; odczytuje jedynie ich logi kontenerów Docker. Agent śledzi każdy plik w miarę jego wzrostu, rozpoznaje pliki rotowane, aby nic nie było odczytywane dwukrotnie, odczytuje każdy plik. .gz archiwizuje raz i uzupełnia ostatnie 30 dni przy pierwszym odczycie.

Czego będziesz potrzebować

Konto Query Streams

MCP jest dostępny w każdym planie, w tym w planie darmowym. Plan darmowy obejmuje jeden klucz lub jedną powiązaną aplikację, czyli wszystko, czego potrzebujesz w tym przewodniku. Zarejestruj się na my.querystreams.com.

Agent na komputerze, który może otworzyć folder

Wersja 2.6.0 lub nowsza. Folder może znajdować się na tym komputerze lub w udziale plików, do którego ma dostęp. Agent działa jako usługa, więc wpisz „shares” jako \\serwer\udział\folder, a nie jako zmapowana litera dysku. W systemie Windows można zalogować się do udziału za pomocą przechowywanego loginu; w systemie Linux lub Mac należy najpierw zamontować udział (Linux pod /mnt lub /głoska bezdźwięczna, Mac pod /Kłęby). Nowość u agenta? Zainstaluj w systemie Windows, macOS lub Linux.

MCP włączony dla Ciebie

Twórcy, właściciele i administratorzy mają to od samego początku. Wszyscy inni potrzebują administratora, żeby to zmienić. MCP przełącznik obok ich imienia pod Konto → Kontrola dostępuDo tego czasu na stronie MCP będzie widniał komunikat „MCP jest wyłączony dla Twojego konta”.

Klient AI

Claude w wersji webowej, Claude Desktop lub aplikacje mobilne Claude łączą się bez użycia klucza. Działają również Claude Code, Cursor, ChatGPT i około dziesięciu innych narzędzi; Portal ma gotowy przepis na każde z nich.

Skonfiguruj w czterech krokach

1. Wskaż agenta na folder

   W portalu otwórz Dane → Agenci danych, znajdź agenta, który może otworzyć folder i kliknij jego Dodaj złącze przycisk. Pod Pliki i foldery kliknij pigułkę Dzienniki kontenerowe Karta. Następnie kreator przeprowadzi Cię przez Lornetka składana, Sprawdzać, Ustawienia, Królestwo oraz Recenzja:

   Lornetka składana

   Wpisz Foldery główne, po jednym w każdym wierszu, jako ścieżki na komputerze Agenta. Skanuj podfoldery jest włączony, Maksymalna głębokość wynosi 8. Uwzględnij wzorce zaczyna się od właściwego globu dla tego typu pliku; dodaj Wyklucz wzorce Jeśli folder zawiera pliki, których nie chcesz. Zmapowana litera dysku wyświetla bursztynowy komunikat: Agent jej nie widzi, więc użyj \\serwer\udział zamiast tego ścieżka.

   Sprawdzać

   Agent odczytuje próbkę do 64 plików i pokazuje, co zbuduje. Nic jeszcze nie zostało utworzone. Gotowy do stworzenia oznacza, że każdy próbkowany plik pasuje. Bursztynowy baner z informacją „{n} z {m} plików zostanie odłożonych” wyświetla listę plików, które nie pasują Pokaż, które pliki i dlaczego; możesz utworzyć łącznik i tak, a następnie naprawić go później. Jeśli folder zawiera różne układy, niebieski panel oferuje Przełącz się na jedną tabelę na układ.

   Ustawienia

   Interwał skanowania (domyślnie co godzinę, od co 5 minut do codziennie) określa częstotliwość, z jaką Agent sprawdza nowe, zmienione i zniknięte pliki. Obserwuj folder pod kątem zmian reaguje w ciągu kilku sekund na dyskach lokalnych. Kiedy plik znika Jest Upuść jego wiersze domyślnie.

   Realm, Recenzja

   Wybierz obszar danych, do którego mają być przypisane wiersze, sprawdź podsumowanie i kliknij Utwórz łącznik. Pierwsze skanowanie rozpoczyna się natychmiast; złącze Oczywisty Karta pokazuje, co zostało zbudowane i jakie pliki zostało odłożone.

   • Dodaj folder, w którym znajdują się dzienniki kontenerów Foldery główne. Uwzględnij wzorce zacząć jako **/*-json.log, **/*.dziennik oraz **/*.dziennik.*.
   • Wybierz Typ dziennikaKarta dostarcza plik Docker json, dzienniki dokera --znaczniki czasu eksport i Portainer.
   • Nazwa tabeli jest opcjonalny i domyślnie wynosi wydarzenia.
   • NA SprawdzaćAgent odczytuje próbkę i wyświetla liczbę plików, rozmiar, szacunkową liczbę wierszy oraz tabele, które zostaną utworzone. Nic jeszcze nie zostało utworzone. Jeśli pliki nie wyglądają na pliki o wybranym typie, nagłówek brzmi: Te pliki nie są a następnie ten typ i powód.

2. Zobacz, jakie stoły otrzymasz

   Przeanalizowane linie trafiają do zestaw_plików.zdarzenialub w Nazwa tabeli Wybrałeś. Agent przechowuje wiersze w lokalnej pamięci podręcznej na komputerze agenta i obsługuje je jako SQL. Każdy wiersz zawiera informację o pliku, z którego pochodzi. _plik_źródłowyPoniższe kolumny pochodzą z domyślnego typu dziennika pliku json Docker.

   Tabela	Co zawiera
   wydarzenia	Jeden wiersz na linię dziennika: czas_wydarzenia, aplikacja (nazwa kontenera), strumień oraz wiadomość, plus obraz, usługa_kompozycji oraz identyfikator_kontenera.
   wydarzenia_surowe_linie	Linie, które nie zostały przeanalizowane, zachowane w linia z powód jak na przykład brak dopasowania gramatycznego lub niemożliwy do rozszyfrowania. Nic nie jest upuszczane.
   akta	Każdy plik dziennika w folderze w tej chwili, z ścieżka_względna, rozmiar_bajtów oraz zmodyfikowany_utc.
   pliki_wydarzenia	Historia każdego pliku: pojawił się, zmodyfikowany, obrócony, kadłubowy oraz dryf rzędy, mierzone przez wydarzenie_w.
   kursory logu	Pozycja i stan odczytu każdego pliku. Plik odłożony pokazuje stan zaparkowany z powodem w ostatni_błąd.

   Każdy łącznik folderów zapewnia Claude'owi te same tabele księgowe, wszystkie w zestaw plików schemat:

   Tabela	Co zawiera
   akta	Każdy plik aktualnie znajdujący się w folderze: ścieżka, nazwa, rozszerzenie, rozmiar, czas utworzenia i modyfikacji. Zapytaj: „Co jest w tym folderze?”, a Claude to przeczyta.
   pliki_wydarzenia	Historia zmian: jeden wiersz na plik, który się pojawił, został zmodyfikowany, zniknął lub został odłożony (dryf), z czasem w wydarzenie_w i powód w szczegół.
   katalogi, kłęby	Rozmiary i liczba folderów oraz dyski lub udziały, na których są przechowywane.
   _plik_źródłowy, _id_wiersza	Dwie kolumny w każdym wierszu danych: z którego pliku pochodzi wiersz i identyfikator stabilnego wiersza w tym pliku. Grupuj według _plik_źródłowy aby porównać pliki.

3. Połącz Claude'a

   Otwórz Transmisje strumieniowe → Na żywo → MCPIstnieją dwie drogi dojazdowe, które kończą się w tym samym miejscu:

   Aplikacje do czatów · bez klucza

   claude.ai, Claude Desktop, ChatGPT

   W claude.ai i Claude Desktop otwórz Lista strumieni zapytań w katalogu złączy Anthropic kliknij Łączyć i zatwierdź. Dodając go przez adres URL, https://mcp.querystreams.com/mcp, to rozwiązanie awaryjne. W ChatGPT dodajesz strumienie zapytań z aplikacji (na razie w trybie programistycznym) i logujesz się za pomocą strumieni zapytań. W obu przypadkach otworzy się strona strumieni zapytań: wybierz organizację i uprawnienia, a następnie kliknij Zatwierdź połączenie. Nic do kopiowania. Połączenie pojawia się na Połączenia kartę i można ją tam odwołać.

   Narzędzia programistyczne · klucz

   Claude Code, Cursor, VS Code i przyjaciele

   Na stronie MCP kliknij Połącz klienta AIPrzewodnik pyta W jaki sposób połączy się Twój klient AI?: wybierać Użyj klucza w pliku konfiguracyjnym, wybierz swoje narzędzie, a następnie Wygeneruj klucz dla to: a Nazwa klucza, Czytać oraz Uruchom zapytania zaznaczone, Wygaśnięcie (Nigdy, 30 dni, 90 dni lub 1 rok). Skonfiguruj to pokazuje fragment kodu z wypełnionym kluczem i Sprawdź połączenie czeka na pierwsze połączenie.

   Obie metody wykorzystują te same trzy uprawnienia, które wybierasz na ekranie zgody lub za pomocą klucza:

   Czytać

   Wyświetlaj łączniki, przeglądaj tabele i kolumny, odczytuj zapisane zapytania i reguły alertów. Nigdy nie zwraca danych wierszowych.

   Uruchom zapytania

   Uruchom zapytania SQL tylko do odczytu i zapisane zapytania za pośrednictwem agenta i zwróć wiersze. Bez tego klient AI może opisać dane, ale nie może na nie odpowiedzieć.

   Analizować

   Twórz profile tabel, odkrywaj relacje i dodawaj do kolejki uruchomienie Semantic Intelligence. Profilowanie i odkrywanie są bezpłatne; uruchomienie Semantic Intelligence zużywa kredyty Nova AI i limit danych, dlatego na ekranie zgody ta opcja nigdy nie jest zaznaczona domyślnie.

   Zgubiłeś klucz? Jest on wymieniony na Połączenia patka: Pokaż pełny klucz pokazuje to ponownie i Skopiuj pełny klucz Kopiuje go. Cofnij go tam, jeśli laptop zginie; każdy klient, który go używa, straci połączenie przy następnym połączeniu, w ciągu około pięciu minut.

   Następnie wybierz przepis na Claude'a, którego używasz. Adres serwera jest wszędzie taki sam: https://mcp.querystreams.com/mcp.

   Claude w sieci, Claude na komputerze i urządzeniu mobilnym bez klucza

   1. Otwórz Lista strumieni zapytań w katalogu złączy Anthropic i kliknij Łączyć. Na pulpicie znajduje się pod + → Konektory.
   2. Rozwiązanie awaryjne, jeśli Twoja organizacja ukrywa łączniki katalogowe: Ustawienia → Łączniki → Dodaj niestandardowy łącznik, nazwa Strumienie zapytań, adres URL https://mcp.querystreams.com/mcp, Pola OAuth puste, Dodaj; następnie na czacie + → Strumienie zapytań → Łączyć.
   3. Otworzy się karta „Strumienie zapytań”. Zaloguj się, jeśli zostaniesz o to poproszony, wybierz organizację i sprawdź Czytać oraz Uruchom zapytania, opcjonalnie Ogranicz do określonych złączyi kliknij Zatwierdź połączenie.
   4. W Claude widzisz „Połączono ze strumieniami zapytań”. Za pierwszym razem, gdy Claude używa narzędzia, pojawia się pytanie: wybierz Zawsze pozwalaj.

   Jeśli dodasz go ręcznie w Claude Desktop, użyj Ustawienia → Łączniki → Dodaj, nie na czacie Dodaj rynek Opcja, która oczekuje repozytorium Git. Konektory synchronizują się z kontem Claude, więc aplikacje mobilne i pulpit automatycznie je wychwytują. Nazwy menu są Anthropic i można je przenosić.

   Kod Claude'a klawisz

   Jedno polecenie z kluczem z zakładki Połączenia:

   Terminal

   claude mcp add --transport http querystreams https://mcp.querystreams.com/mcp \ --header "Klucz X-MCP: qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ"

   To pisze obecny projekt .mcp.json. Dodać --scope użytkownik mieć strumienie zapytań w każdym projekcie. Uruchom /mcp wewnątrz Claude Code, aby zobaczyć połączenie.

   Kursor klawisz

   Otwórz Ustawienia kursora → MCP → Dodaj nowy serwer MCPlub edytuj .kursor/mcp.json u podstaw Twojego miejsca pracy:

   .kursor/mcp.json

   { "mcpServers": { "querystreams": { "url": "https://mcp.querystreams.com/mcp", "headers": { "Klucz X-MCP": "qsmcp_WKLEJ_TUTAJ_SWÓJ_KLUCZ" } } } }

   Uruchom ponownie kursor lub uruchom MCP: Uruchom ponownie serwery; A strumienie zapytań Odznaka pojawia się na pasku stanu MCP.

   Używasz czegoś innego? Portalu Połącz klienta AI przewodnik zawiera gotowe do wklejenia przepisy dla ChatGPT, VS Code, Visual Studio, OpenAI Codex CLI, Gemini CLI, Windsurf, Zed, Cline, Continue.dev i JetBrains AI, a także Wklej i scal narzędzie, które upuszcza strumienie zapytań wpis do pliku konfiguracyjnego, który już posiadasz. Każdy klient obsługujący protokół MCP przez HTTP działa: serwer https://mcp.querystreams.com/mcp, nagłówek Klucz X-MCP (jakiś Autoryzacja: Posiadacz nagłówek z tym samym kluczem również działa).

4. Zadaj swoje pierwsze pytanie

   Zacznij od czegoś, co możesz sprawdzić, otwierając folder, tak aby Claude sięgnął po odpowiednią tabelę. Trzy, które dobrze współpracują z logami kontenera Docker:

   „Które pliki dziennika kontenera czytasz i kiedy nastąpiła ostatnia zmiana?”

   Claude pyta zestaw_plików.pliki Do ścieżka_względna, rozmiar_bajtów oraz zmodyfikowany_utc, najnowsze na górze.

   „Ile linii stderr zapisał każdy kontener w ciągu ostatniej godziny?”

   Claude liczy rzędy w zestaw_plików.zdarzenia przez aplikacja Gdzie strumień jest stderr, filtrowany według czas_wydarzenia.

   „Czy dzisiaj dokonano rotacji lub odłożenia jakichkolwiek plików dziennika kontenerów?”

   Claude czyta zestaw_plików.zdarzenia_plików Do obrócony oraz dryf wiersze, uporządkowane według wydarzenie_wi nadaje nazwę każdemu plikowi.

   Aby potwierdzić okablowanie, zapytaj „Jakie mam łączniki Query Streams?”. Claude dzwoni qs_list_connectors, przewodnik po portalu Sprawdź połączenie krok mówi Połączonyi klucz lub aplikację na Połączenia karta pokazuje swoje Ostatnio używane w ciągu kilku sekund.

Dostęp do pliku w udziale sieciowym

Agent otwiera pliki jako usługa w tle, a nie jako użytkownik, więc otwieranie plików na innym komputerze wymaga wykonania jednego dodatkowego kroku. Który krok zależy od komputera, na którym działa Agent.

Jeżeli test nie może dotrzeć do udziału, w jego wynikach poszukaj następujących słów: nieosiągalny oznacza, że komputer agenta nie otrzymał odpowiedzi z serwera. W systemie Linux lub Mac, nie zamontowano oznacza, że udział nadal musi zostać zamontowany, a ta wiadomość zawiera dokładne polecenie montowania dla Twojego serwera.

Jak wyświetlają się nowe, zmienione i usunięte pliki

Co Claude może zrobić po połączeniu

Twój klient AI widzi narzędzia Query Streams i wybiera odpowiednie dla Twojego pytania. Portal Narzędzia zakładka zawiera listę wszystkich narzędzi i trybów dostępnych w ramach Twojego planu. Query Streams prosi klienta AI o odczytanie kolumn każdej tabeli przed wykonaniem zapytania, dzięki czemu używa prawdziwych nazw zamiast zgadywać. W każdym planie, także Free:

Zestaw narzędzi analitycznych. W przypadku planów płatnych Agent wykonuje pracę przygotowawczą, w której znajduje się plik dzienników kontenerów, dzięki czemu klient AI koncentruje się na procesie myślowym. Wersja darmowa działa tak samo, jak zawsze.

Domyślne ustawienia są dostępne na Kontekst zakładka: limit liczby komórek tekstowych, widok schematu, rozmiar wyniku, domyślne ustawienia analizy i wstrzymane wyniki.

Dlaczego inteligencja semantyczna ma tu znaczenie

Każda odpowiedź, którą otrzymuje Claude, jest oznaczona informacją o źródle struktury, a Claude dostosowuje stopień zaufania do tego, co widzi.

Jeśli baza danych ma znaczenie, uruchom na niej inteligencję semantyczną raz Nova → Inteligencja. Ten Połączenia Karta pokazuje panel pokrycia dla każdego złącza. Jak działa inteligencja semantyczna.

Co pozwalają plany

Usługa MCP jest dostępna w każdym planie, w tym w planie darmowym, bez dodatkowych opłat. Każdy plan określa liczbę kluczy lub podłączonych aplikacji, które możesz przytrzymać, oraz liczbę połączeń na minutę, jakie może wykonać Twój klient AI:

Połączona aplikacja jest liczona jako klucz. Oprócz liczby zapytań na minutę, każdy klucz może wykonać maksymalnie 10 zapytań na minutę. Zapytanie trwa do 60 sekund, chyba że klient AI poprosi o więcej, maksymalnie pięć minut. Plan określa również liczbę wierszy zwracanych przez jedno zapytanie oraz, za pomocą zestawu narzędzi analitycznych, czas trwania i rozmiar przechowywanego wyniku. pełny przewodnik MCP wyświetla wszystkie plany. To, co otrzymuje Twój klient AI, jest wliczane do limitu Data Realm, czyli tej samej puli, z której korzystają zapytania Excel i Sheets: użycie agenta AI (MCP) obejmuje każdy bajt dostarczony do klienta AI — wyniki, odczyty schematu i strony z zatrzymanymi wynikami — przed kompresją transportową uzgodnioną przez klienta. W przypadku zapytań arkuszy kalkulacyjnych liczony jest skompresowany wynik dostarczony przez agenta Network Agent. Uruchomienia Semantic Intelligence rozpoczęte z poziomu klienta AI zużywają kredyty Nova AI, tak samo jak uruchomienia z poziomu Portalu. Zobacz stronę z cennikiem za dodatki.

Dbanie o bezpieczeństwo

Dobre następne ruchy

• Włącz opcję „Obserwuj folder pod kątem zmian” (w czasie zbliżonym do rzeczywistego) aby w ciągu kilku sekund wykryć nowe linie na dysku lokalnym. Zaplanowane skanowanie pozostaje gwarantowane.
• Ustaw opcję Zachowaj zdarzenia na N dni Aby kontrolować, ile historii pozostaje w pamięci podręcznej. Logi kontenerów są domyślnie przechowywane przez 30 dni.
• Otwórz okno dialogowe Pliki na złączu, aby zobaczyć każdy plik dziennika odczytywany przez Agenta i dlaczego każdy z nich jest odkładany.

Kiedy coś nie działa

Pytania, które zadają ludzie

Powiązane przewodniki

• Połącz folder plików CSV z Claude za pomocą MCP
• Połącz folder plików Excel z Claude za pomocą MCP
• Połącz folder baz danych SQLite z Claude za pomocą MCP
• Połącz folder plików Parquet z Claude za pomocą MCP
• Łączenie strumieni zapytań z Claude za pośrednictwem MCP: konfiguracja, uprawnienia i rozwiązywanie problemów
• Wszystkie przewodniki MCP