Εξερεύνηση: Αναζήτηση και επιθεώρηση ιχνών παραγωγής
Σε αυτήν τη σελίδα
Μάθημα ξαναγραμμένο στις 2 Νοεμβρίου 2026 με βάση τις σελίδες Send traces και Explore traces της Mistral και το SDK
mistralai3.7.0: Ο Εξερευνητής εστιάζει σε ίχνη OpenTelemetry που αναζητούνται μέσω μιας γλώσσας εκφράσεων αναζήτησης· η παλιά μέθοδοςchat_completion_events.searchδεν υπάρχει πλέον. Πηγές: Send traces · Explore traces.
Ο Εξερευνητής: Το παράθυρό σας στην παραγωγή
Ο Εξερευνητής Ιχνών (Trace Explorer) είναι το σημείο όπου αναζητάτε, φιλτράρετε και επιθεωρείτε κάθε ίχνος που διαρρέει τις εφαρμογές τεχνητής νοημοσύνης σας. Θα τον βρείτε στο Studio κάτω από Observability → Traces. Ωστόσο, τα ίχνη δεν θα εμφανιστούν εκεί εκτός αν τα ενεργοποιήσετε πρώτα: η ιχνηλάτηση είναι απενεργοποιημένη από προεπιλογή.
Αποστολή ιχνών
Με το Python SDK, εγκαταστήστε την επέκταση τηλεμετρίας (mistralai[telemetry], έκδοση 2.4.13 ή νεότερη) και, στη συνέχεια, ενεργοποιήστε την στον πελάτη:
from mistralai.client import Mistral
from mistralai.extra.observability import configure_telemetry
client = Mistral(api_key="your-api-key")
configure_telemetry(client)
Από εκεί και πέρα, το SDK ιχνηλατεί αυτόματα κλήσεις μοντέλων, ενσωματώσεις (embeddings), λειτουργίες πρακτόρων, ολοκληρώσεις FIM και OCR. Οι κλήσεις στα δικά σας εργαλεία δεν ιχνηλατούνται εξ ορισμού: πρέπει να προσθέσετε τα διαστήματά τους (spans) χρησιμοποιώντας τον ιχνηλάτη του SDK.
from mistralai.extra.observability import get_telemetry_tracer
tracer = get_telemetry_tracer(client, "agent-support")
with tracer.start_as_current_span("invoke_agent"):
response = client.chat.complete(
model="mistral-small-latest",
messages=[{"role": "user", "content": "What is the status of order 4521?"}],
)
with tracer.start_as_current_span("execute_tool order_tracking") as span_tool:
span_tool.set_attribute("gen_ai.tool.name", "order_tracking")
span_tool.set_attribute("gen_ai.tool.call.arguments", "4521")
# call your tool here
Άλλες πηγές συμπεριφέρονται διαφορετικά: Τα Workflows ιχνηλατούν κάθε εκτέλεση μόλις οριστεί OTEL_ENABLED=true στην υπηρεσία, ενώ το Vibe Work ενεργοποιείται μέσω μιας ρύθμισης διαχειριστή στο Studio. Το TypeScript SDK προσφέρει το configureTelemetry. Αντιθέτως, το Vibe Code (CLI και Web) και το Playground του Studio δεν στέλνουν ίχνη. Όλες οι πηγές αποκρύπτουν μέρος των δεδομένων από προεπιλογή πριν την εξαγωγή· η σελίδα Data redaction λεπτομερεί αυτή την πολιτική και τον τρόπο προσαρμογής της.
Τι περιέχει ένα ίχνος
Ένα ίχνος είναι ένα δέντρο διαστημάτων (spans), όπου κάθε διάστημα αντιπροσωπεύει μια λειτουργία στην αλυσίδα:
| Πεδίο | Περιεχόμενο |
|---|---|
| Trace ID | Αναγνωριστικό για ολόκληρη την αλυσίδα εκτέλεσης |
| Spans | Λειτουργίες: κλήσεις μοντέλων, κλήσεις εργαλείων, βήματα ροής εργασίας |
| Duration | Χρόνος για κάθε διάστημα και για ολόκληρο το ίχνος |
| Tokens | Tokens εισόδου και εξόδου για κάθε κλήση μοντέλου |
| Status | Επιτυχία ή σφάλμα, συμπεριλαμβανομένου του μηνύματος σφάλματος |
| Source | Προϊόν προέλευσης: SDK, Workflows, Vibe Work |
| Tags | Ετικέτες που εφαρμόζονται από το SDK και αυτόματα μεταδεδομένα, όπως το μοντέλο |
Κάνοντας κλικ σε ένα ίχνος ανοίγει το δέντρο των διαστημάτων του· κάθε διάστημα αναπτύσσεται για να εμφανίσει την είσοδο, την έξοδο, τον χρόνο απόκρισης (latency) και τα tokens.
Η γλώσσα αναζήτησης
Ο Εξερευνητής δέχεται μια γλώσσα εκφράσεων: συνθήκες σε πεδία ιχνών συνδυασμένες με AND, OR και NOT.
| Κατηγορία | Τελεστές | Παράδειγμα |
|---|---|---|
| Σύγκριση | =, !=, <, <=, >, >= | duration_ns > 5000000000 |
| Πρότυπο | LIKE, ILIKE, NOT LIKE | service_name LIKE '%agent%' |
| Υποσυμβολοσειρά | CONTAINS, NOT CONTAINS | service_name CONTAINS 'sdk' |
| Κανονική έκφραση | REGEXP, NOT REGEXP | service_name REGEXP '^my-' |
| Εύρος | BETWEEN ... AND ... | duration_ns BETWEEN 1000000 AND 5000000000 |
| Λίστα | IN (...), NOT IN (...) | status_code IN ('Error', 'Ok') |
| Παρουσία | EXISTS, NOT EXISTS | error_message EXISTS |
Τα διαθέσιμα πεδία περιλαμβάνουν τα service_name, status_code (Ok ή Error), duration_ns (σε νανοδευτερόλεπτα), error_message, start_time, models_used (μια λίστα) και οποιοδήποτε χαρακτηριστικό διαστήματος χρησιμοποιώντας σύνταξη με αγκύλες: span_attributes['gen_ai.request.model']. Για λίστες, οι συναρτήσεις has(models_used, 'mistral-medium-latest'), hasany(...) και hasall(...) συμπληρώνουν το CONTAINS.
# Όλα τα αποτυχημένα ίχνη από μια υπηρεσία
service_name = 'agent-support' AND status_code = 'Error'
# Ίχνη μεγαλύτερα από 5 δευτερόλεπτα
duration_ns > 5000000000
# Ίχνη που κάλεσαν ένα συγκεκριμένο μοντέλο
span_attributes['gen_ai.request.model'] CONTAINS 'mistral-large'
Εάν μια αναζήτηση δεν επιστρέψει αποτελέσματα, αφαιρέστε όλες τις συνθήκες εκτός από το χρονικό εύρος και, στη συνέχεια, προσθέστε τες ξανά μία προς μία. Ένα συχνό λάθος είναι το φιλτράρισμα για status_code = 'Error' όταν τα περισσότερα ίχνη είναι επιτυχημένα.
Ερωτήματα ιχνών μέσω του SDK
Μπορείτε να εκτελέσετε τις ίδιες αναζητήσεις προγραμματιστικά σε ένα χρονικό εύρος:
from datetime import datetime, timedelta, timezone
from mistralai.client import Mistral
client = Mistral(api_key="your-api-key")
now = datetime.now(timezone.utc)
response = client.beta.observability.traces.search(
from_=now - timedelta(days=1),
to=now,
search_expression="service_name = 'agent-support' AND status_code = 'Error'",
page_size=50,
)
for trace in response.traces.results or []:
print(f"{trace.trace_id} {trace.root_span_name} : {trace.duration_ns / 1e9:.1f} s")
Η απόκριση χρησιμοποιείσελιδοποίηση βασισμένη σε δρομέα (cursor-based pagination). Η αναφορά API τεκμηριώνει τα τελικά σημεία Traces και Spans (αναζήτηση, μεμονωμένο ίχνος, πιθανά πεδία και τιμές, διαστήματα ενός ίχνους).
Προσθήκη διαστημάτων σε ένα σύνολο δεδομένων
Ο Εξερευνητής λειτουργεί επίσης ως σημείο εκκίνησης για σύνολα δεδομένων δοκιμών. Από ένα ίχνος, το μενού ενός διαστήματος προσφέρει την επιλογή Add span to dataset· στην προβολή Spans, μπορείτε να επιλέξετε έως και 500 ταυτόχρονα και να αντιστοιχίσετε κάθε πεδίο διαστήματος σε ένα πεδίο εγγραφής. Αυτή η λειτουργία σχετίζεται με offline αξιολογήσεις, οι οποίες προορίζονται για οργανισμούς Enterprise (Μάθημα 15).
Βασικά σημεία
- Η ιχνηλάτηση είναι απενεργοποιημένη από προεπιλογή: το
configure_telemetry(client)την ενεργοποιεί για το Python SDK, ενώ τοOTEL_ENABLED=trueγια τα Workflows - Οι κλήσεις μοντέλων ιχνηλατούνται αυτόματα· οι κλήσεις εργαλείων απαιτούν χειροκίνητη ιχνηλάτηση με το
get_telemetry_tracer - Ο Εξερευνητής φιλτράρει ίχνη χρησιμοποιώντας μια γλώσσα εκφράσεων (
service_name,status_code,duration_ns,span_attributes['…']) - Το SDK εκθέτει την ίδια δυνατότητα αναζήτησης:
client.beta.observability.traces.search(search_expression=...) - Τα ενδιαφέροντα διαστήματα γίνονται εγγραφές συνόλου δεδομένων με ένα κλικ ή σε παρτίδες των 500