베타 Observability 로그 엔드포인트

베타 Observability 로그 엔드포인트 (Beta Observability Logs Endpoints)

(beta) Observability API - logs입니다. 로그를 검색하고, 필드 정의를 조회하며, 특정 필드의 옵션 목록을 가져오는 엔드포인트예요.

출처: 문서

본문

관측성(observability) 로그를 다루는 베타 엔드포인트 모음이에요. 로그를 조건으로 검색하고, 어떤 필드가 있는지 정의를 확인하고, 특정 필드에서 쓸 수 있는 값(옵션)을 조회할 수 있답니다.

POST /v1/observability/logs/search — Search logs (로그 검색)

로그를 검색합니다.

요청 본문:

  • search_expression#string|null — 검색 표현식.
  • order#"asc"|"desc" — 기본값 "desc". 정렬 방향.

응답 필드 (200 Successful Response):

  • logs#FeedResultGetLog (필수) — 검색 결과 로그.

Python:

from mistralai.client import Mistral
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.logs.search(page_size=50, order="desc")

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/observability/logs/search \
 -X POST \
 -H 'Authorization: Bearer ***' \
 -H 'Content-Type: application/json' \
 -d '{}'

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.observability.logs.search({
    logsRequest: {},
  });

  console.log(result);
}

run();

응답 예시 (200):

{
  "logs": {}
}

GET /v1/observability/logs/fields — Get log field definitions (로그 필드 정의 조회)

로그 필드 정의를 가져옵니다.

응답 필드 (200 Successful Response):

  • field_definitions#array<OtelFieldDefinition> (필수) — 필드 정의 목록.

Python:

from mistralai.client import Mistral
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.logs.list()

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/observability/logs/fields \
 -X GET \
 -H 'Authorization: Bearer ***'

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.observability.logs.list();

  console.log(result);
}

run();

응답 예시 (200):

{
  "field_definitions": [
    {
      "label": "approved",
      "name": "My resource",
      "supported_aggregations": [
        "count"
      ],
      "supported_operators": [
        "eq"
      ],
      "type": "ENUM"
    }
  ]
}

GET /v1/observability/logs/fields/{field_name}/options — Get options for a log field (로그 필드 옵션 조회)

특정 로그 필드에서 사용 가능한 옵션 값을 가져옵니다.

경로 파라미터:

  • field_name#string (필수)

쿼리 파라미터:

  • from#date-time|null — 시작 시각.
  • to#date-time|null — 종료 시각.

응답 필드 (200 Successful Response):

  • options#array<string>|null (필수) — 옵션 값 목록.

Python:

from mistralai.client import Mistral
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.observability.logs.fetch_options(field_name="<value>")

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/observability/logs/fields/{field_name}/options \
 -X GET \
 -H 'Authorization: Bearer ***'

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.observability.logs.fetchOptions({
    fieldName: "<value>",
  });

  console.log(result);
}

run();

응답 예시 (200):

{
  "options": null
}

더 알아보기 (Learn more)