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

# Log requests

> Log requests based on the selected formatter.

export const FormField = ({property, label, required = false, diType, uiPatterns, children}) => {
  const patterns = Array.isArray(uiPatterns) ? uiPatterns : uiPatterns ? [uiPatterns] : [];
  return <div style={{
    margin: '1.5rem 0'
  }}>
      <div style={{
    display: 'flex',
    alignItems: 'baseline',
    flexWrap: 'wrap',
    gap: '0.5rem',
    marginBottom: '0.25rem'
  }}>
        <strong>{label}</strong>
        <span style={{
    fontSize: '0.7rem',
    fontWeight: 600,
    textTransform: 'uppercase',
    letterSpacing: '0.04em',
    color: required ? '#6241f5' : '#6b7280'
  }}>
          {required ? 'Required' : 'Optional'}
        </span>
      </div>

      <div>{children}</div>

      {diType || patterns.length > 0 ? <p style={{
    fontSize: '0.85rem',
    color: '#6b7280',
    marginBottom: 0
  }}>
          {diType ? <>
              See the <a href={`/references/${diType}`}>{diType}</a> reference.{' '}
            </> : null}
          {patterns.length > 0 ? <>
              Accepts a <a href={`/documentation/placeholders-and-patterns/patterns#${patterns[0]}`}>pattern</a>.
            </> : null}
        </p> : null}
    </div>;
};

Records every request the connection sends and every response it receives in the Alumio logs, so you can see exactly what went over the wire when you are debugging an integration. Each log entry captures the request method, URL and headers, the response status and headers, and how long the call took. How much of the request and response body is included depends on the formatter you choose.

This documentation describes: [Schema](/schemas/http-client-plugin-configurator/logger)

## Fields

<FormField property="formatter" label="Formatter" diType="http-message-formatter">
  Decides how much of each request and response is written to the log. Leave it empty to log headers only, which is the recommended setting and keeps bodies out of the logs. Pick a formatter when you also need to see the request or response body, but be mindful that bodies can be large and may contain sensitive data.
</FormField>

## Sample data

This plugin writes log entries rather than transforming data, so there is no before/after to show. The example below logs headers only by leaving the formatter unset, which is the recommended choice for most connections.

| Field     | Value                 |
| --------- | --------------------- |
| Formatter | (empty: headers only) |

```json Configuration theme={null}
{
  "prototype": "logger",
  "parameters": {}
}
```