Skip to content

docs(logs): Add UI settings method for configuring person pivot attribute #17305

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
inkeep wants to merge 1 commit into
base: master
Choose a base branch
from
Open

docs(logs): Add UI settings method for configuring person pivot attribute #17305

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 16 additions & 12 deletions contents/docs/logs/link-person.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,24 +35,24 @@ When you emit logs directly via OpenTelemetry from a backend — Python, Go, Nod
<MultiLanguage>

```javascript file=JavaScript
import { logs } from '@opentelemetry/api-logs'
import { logs } from "@opentelemetry/api-logs";

const logger = logs.getLogger('my-app')
const logger = logs.getLogger("my-app");

app.post('/api/checkout', async (req, res) => {
const userId = req.userId // ... get your user ID
app.post("/api/checkout", async (req, res) => {
const userId = req.userId; // ... get your user ID

logger.emit({
severityText: 'info',
body: 'Checkout completed',
severityText: "info",
body: "Checkout completed",
attributes: {
posthogDistinctId: userId, // Links to PostHog person
orderId: 'A-123',
posthogDistinctId: userId, // Links to PostHog person
orderId: "A-123",
},
})
});

res.json({ success: true })
})
res.json({ success: true });
});
```

```python file=Python
Expand Down Expand Up @@ -105,7 +105,11 @@ If the log does not appear, check:

## Customizing the attribute key

If your pipeline emits the person identifier under a different key (for example `user.id`, `customerId`, or a legacy `distinct_id`), point PostHog at that key with the `logs_config` endpoint:
If your pipeline emits the person identifier under a different key (for example `user.id`, `customerId`, or a legacy `distinct_id`), you can change it in [**Settings** > **Logs**](https://app.posthog.com/settings/environment-logs#logs-distinct-id-attribute-key) under **Link to person**. This setting requires admin access.

You can also reach this setting from the gear icon on any person's **Logs** tab.

Alternatively, update it via the API:

```bash
curl -X PATCH "https://app.posthog.com/api/projects/<PROJECT_ID>/logs_config/" \
Expand Down
Loading