Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Εξερεύνηση: Αναζήτηση και επιθεώρηση ιχνών παραγωγής

Μάθημα 12 / 16 Ενημερώθηκε 2 Νοεμβρίου 2026 Προχωρημένος
Σε αυτήν τη σελίδα
  1. Ο Εξερευνητής: Το παράθυρό σας στην παραγωγή
  2. Αποστολή ιχνών
  3. Τι περιέχει ένα ίχνος
  4. Η γλώσσα αναζήτησης
  5. Ερωτήματα ιχνών μέσω του SDK
  6. Προσθήκη διαστημάτων σε ένα σύνολο δεδομένων
  7. Βασικά σημεία

Μάθημα ξαναγραμμένο στις 2 Νοεμβρίου 2026 με βάση τις σελίδες Send traces και Explore traces της Mistral και το SDK mistralai 3.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Χρόνος για κάθε διάστημα και για ολόκληρο το ίχνος
TokensTokens εισόδου και εξόδου για κάθε κλήση μοντέλου
StatusΕπιτυχία ή σφάλμα, συμπεριλαμβανομένου του μηνύματος σφάλματος
SourceΠροϊόν προέλευσης: SDK, Workflows, Vibe Work
TagsΕτικέτες που εφαρμόζονται από το SDK και αυτόματα μεταδεδομένα, όπως το μοντέλο

Κάνοντας κλικ σε ένα ίχνος ανοίγει το δέντρο των διαστημάτων του· κάθε διάστημα αναπτύσσεται για να εμφανίσει την είσοδο, την έξοδο, τον χρόνο απόκρισης (latency) και τα tokens.

Η γλώσσα αναζήτησης

Ο Εξερευνητής δέχεται μια γλώσσα εκφράσεων: συνθήκες σε πεδία ιχνών συνδυασμένες με AND, OR και NOT.

ΚατηγορίαΤελεστέςΠαράδειγμα
Σύγκριση=, !=, <, <=, >, >=duration_ns > 5000000000
ΠρότυποLIKE, ILIKE, NOT LIKEservice_name LIKE '%agent%'
ΥποσυμβολοσειράCONTAINS, NOT CONTAINSservice_name CONTAINS 'sdk'
Κανονική έκφρασηREGEXP, NOT REGEXPservice_name REGEXP '^my-'
ΕύροςBETWEEN ... AND ...duration_ns BETWEEN 1000000 AND 5000000000
ΛίσταIN (...), NOT IN (...)status_code IN ('Error', 'Ok')
ΠαρουσίαEXISTS, NOT EXISTSerror_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