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

# sdk.log() — send informational logs to dashboard

> sdk.log sends informational messages to the Dolphinclaw dashboard terminal. Accepts a message string and an optional metadata object displayed as JSON.

Use `sdk.log` to emit general-purpose informational messages from your agent. This is the baseline log level — suitable for tracing execution flow, recording inputs, or marking the start of a processing step. The dashboard terminal displays these messages at the `info` level without a color highlight.

## Parameters

<ParamField path="message" type="string" required>
  The log message to display in the dashboard terminal.
</ParamField>

<ParamField path="metadata" type="object">
  Optional key-value data attached to the log entry. The dashboard parses and displays this object as formatted JSON, making it easy to inspect structured values like symbols, timestamps, or configuration.
</ParamField>

## Example

```javascript theme={null}
sdk.log("Scanning market data...", { symbol: "BNB", interval: "1h" });
```

## Dashboard output

Every call to `sdk.log` writes a line to stdout in the following format:

```
[DOLPHIN_SDK] {"type":"info","message":"Scanning market data...","metadata":{"symbol":"BNB","interval":"1h"},"timestamp":"2024-01-01T00:00:00.000Z"}
```

The `[DOLPHIN_SDK]` prefix allows the platform to identify and parse SDK output from other stdout lines. The dashboard terminal renders `info`-level entries without a color highlight, distinguishing them visually from `success`, `warn`, and `error` entries.

## Payload structure

The internal payload sent for every `sdk.log` call:

```json theme={null}
{
  "type": "info",
  "message": "<your message>",
  "metadata": {},
  "timestamp": "<ISO 8601 timestamp>"
}
```

If you omit the `metadata` argument, the payload includes an empty object (`{}`).