Skip to main content

Connect Analytics Services to Pharia Assistant

Need to track user behavior and interactions in Pharia Assistant? This guide shows you how to connect PostHog and Grafana Faro to gain insights into how users engage with your assistant.

Prerequisites:

  • Access to your Pharia Assistant Helm deployment
  • PostHog and/or Grafana Faro accounts

Supported Providers​

PostHog Analytics​

Setup PostHog​

Get credentials:

  • API key: Project Settings → Project API Keys
  • API host: Your PostHog instance URL (e.g., https://app.posthog.com)

See PostHog setup guide for detailed instructions.

Configure:

  • Optional: Specify an app identifier for collected telemetry
pharia-assistant:
  posthogToken: "phc_xxxxxxxxxxxxxxxxx"
  posthogApiHost: "https://app.posthog.com"
  instrumentationAppIdentifier: "my-assistant" # Optional

Grafana Faro Telemetry​

Setup Grafana Faro​

Get credentials: After setting up your Faro instance, you can get the telemetry URL and public API key from the Faro instance.

  • Telemetry URL: Your Faro endpoint (e.g., https://your-faro-instance.com/collect)
  • Public API key: If required by your Faro instance

See Faro setup guide for detailed instructions.

Configure:

  • Optional: Specify an app identifier for collected telemetry
pharia-assistant:
  faroTelemetryUrl: "https://your-faro-instance.com/collect"
  faroPublicApiKey: "your-public-api-key"  # Optional
  instrumentationAppIdentifier: "my-assistant" # Optional

Tracked Data​

We track user interactions including chat messages, feature usage, and page navigation to understand how users engage with Pharia Assistant.

Privacy & Compliance​

PII: We do not track personally identifiable information in analytics data.

Identifiers: We generate anonymous identifiers using SHA-256 hashing with a salt. This makes it cryptographically impossible to reverse-engineer the original user ID while still allowing us to track consistent user behavior patterns.

GDPR: We are actively improving our analytics setup to ensure GDPR compliance.