> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keywordsai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Group logs

> Group LLM logs together

You can group LLM logs together by using the `group_identifier` parameter in the request body. This is useful when you want to group logs together for a specific user or a specific task.

## How to group logs?

You can group logs by using the `group_identifier` parameter in the request body.

<Tabs>
  <Tab title="AI gateway">
    <CodeGroup>
      ```python OpenAI Python SDK {11-13} theme={"system"}
      from openai import OpenAI

      client = OpenAI(
          base_url="https://api.keywordsai.co/api/",
          api_key="YOUR_KEYWORDSAI_API_KEY",
      )

      response = client.chat.completions.create(
          model="gpt-4o-mini",
          messages=[{"role":"user", "content":"Tell me a long story"}],
          extra_body={
              "group_identifier": "group_123"
          }
      )
      ```

      ```typescript OpenAI TS SDK {12-13} theme={"system"}
      import { OpenAI } from "openai";

      const client = new OpenAI({
        baseURL: "https://api.keywordsai.co/api",
        apiKey: "YOUR_KEYWORDSAI_API_KEY",
      });

      const response = await client.chat.completions
        .create({
          messages: [{ role: "user", content: "Say this is a test" }],
          model: "gpt-4o-mini",
          // @ts-expect-error
          group_identifier: "group_123",
        })
        .asResponse();

      console.log(await response.json());
      ```

      ```python Python {14} theme={"system"}
      import requests
      def demo_call(input, 
                    model="gpt-4o-mini",
                    token="YOUR_KEYWORDS_AI_API_KEY"
                    ):
          headers = {
              'Content-Type': 'application/json',
              'Authorization': f'Bearer {token}',
          }

          data = {
              'model': model,
              'messages': [{'role': 'user', 'content': input}],
              "group_identifier": "group_123"
          }

          response = requests.post('https://api.keywordsai.co/api/chat/completions', headers=headers, json=data)
          return response

      messages = "Say 'Hello World'"
      print(demo_call(messages).json())

      ```
    </CodeGroup>
  </Tab>

  <Tab title="Logging API">
    <CodeGroup>
      ```python Python {16} theme={"system"}
      import requests

      url = "https://api.keywordsai.co/api/request-logs/create/"
      payload = {
          "model": "claude-3-5-sonnet-20240620",
          "prompt_messages": [
              {
                  "role": "user",
                  "content": "Hi"
              },
          ],
          "completion_message": {
              "role": "assistant",
              "content": "Hi, how can I assist you today?"
          },
          "group_identifier": "group_123"
          # ... other parameters
      }
      headers = {
          "Authorization": "Bearer YOUR_KEYWORDS_AI_API_KEY",
          "Content-Type": "application/json"
      }

      response = requests.request("POST", url, headers=headers, json=payload)
      ```

      ```typescript Typescript {19} theme={"system"}
      const url = 'https://api.keywordsai.co/api/request-logs/create/';
      const headers = {
          'Authorization': 'Bearer YOUR_KEYWORDS_AI_API_KEY',
          'Content-Type': 'application/json'
      };

      const payload = {
          model: 'claude-3-5-sonnet-20240620',
          prompt_messages: [
              {
                  role: "user",
                  content: "Hi"
              },
          ],
          completion_message: {
              role: "assistant",
              content: "Hi, how can I assist you today?"
          },
          group_identifier: "group_123"
          // ... other parameters
      };

      fetch(url, {
          method: 'POST',
          headers: headers,
          body: JSON.stringify(payload)
      })
      .then(response => response.json())
      .then(data => {
          console.log(data);
      })
      ```
    </CodeGroup>
  </Tab>
</Tabs>

## View grouped logs

Once you attach a `group_identifier` to a request, you can view those logs in Logs.

<Frame>
  <img src="https://keywordsai-static.s3.us-east-1.amazonaws.com/docs/observability/logs/log-group.jpg" alt="Group logs" />
</Frame>