:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from typing import Optional, cast
from products.warehouse_sources.sources.debugbear._config import DebugbearSourceConfig
from products.warehouse_sources.sources.debugbear.debugbear import (
debugbear_source,
validate_credentials as validate_debugbear_credentials,
)
from products.warehouse_sources.sources.debugbear.settings import ENDPOINTS, INCREMENTAL_FIELDS
from products.warehouse_sources.sources.sdk import (
CanonicalDescriptions,
DataWarehouseSourceCategory,
ExternalDataSourceType,
FieldType,
ReleaseStatus,
SimpleSource,
SourceConfig,
SourceFieldInputConfig,
SourceFieldInputConfigType,
SourceInputs,
SourceRegistry,
SourceResponse,
SourceSchema,
build_endpoint_schemas,
detect,
)
@SourceRegistry.register
class DebugbearSource(SimpleSource[DebugbearSourceConfig]):
codebase_detection = detect(env=("^DEBUGBEAR_",), script_hosts=("cdn.debugbear.com",), npm=("debugbear",))
lists_tables_without_credentials = True # static endpoint catalog — safe for public docs
api_docs_url = "https://www.debugbear.com/docs/api"
@property
def source_type(self) -> ExternalDataSourceType:
return ExternalDataSourceType.DEBUGBEAR
def get_non_retryable_errors(self) -> dict[str, str | None]:
return {
"401 Client Error": "Your DebugBear API key is invalid or expired. Please generate a new key and reconnect.",
"403 Client Error": "Your DebugBear API key doesn't have permission for this request. Use an Admin API key (Account settings > API Keys) and reconnect.",
"410 Client Error: Gone for url: https://www.debugbear.com": "DebugBear no longer serves this API endpoint, or the account behind this API key was removed. Please contact support to move this source to a supported DebugBear API version.",
# Raised by `_iter_rum_metrics_for_project` after DebugBear 400s on a project with no
# RUM data; the raw message already names the project and the likely fix.
"DebugBear rejected the RUM metrics request": None,
}
def get_retryable_errors(self) -> set[str]:
# `_session`'s `make_tracked_session()` already retries 429/5xx, including the Cloudflare
# 52x/530 family DebugBear can surface on an edge/origin blip, at the urllib3 layer before
# `_get_json`'s `raise_for_status()` can even raise (see `DEFAULT_RETRY` in
# products/warehouse_sources/sources/common/http/transport.py). A response that still exhausts that budget is a
# transient DebugBear/edge issue, not a bug, so Temporal's activity retry recovers once it
# clears rather than surfacing it as tracked exception noise. `raise_for_status` derives
# these prefixes from the status code alone, not the vendor's reason text, so they're
# stable to match on.
#
# `DEFAULT_RETRY`'s connect-retry budget covers a dropped or reset connection the same way —
# a refused connection, a read timeout, or a TLS handshake reset (`SSLError`, which `requests`
# models as a `ConnectionError`) all count against it. urllib3 wraps the exhausted failure as
# "... Max retries exceeded with url: ..." regardless of the underlying cause, the same stable
# prefix Close, Google Sheets, Langfuse, Notion and SigNoz match for their own bespoke sessions.
return {"Server Error", "429 Client Error", "Max retries exceeded with url"}
def get_canonical_descriptions(self) -> CanonicalDescriptions:
from products.warehouse_sources.sources.debugbear.canonical_descriptions import CANONICAL_DESCRIPTIONS
return CANONICAL_DESCRIPTIONS
def get_schemas(
self,
config: DebugbearSourceConfig,
team_id: int,
with_counts: bool = False,
names: list[str] | None = None,
force_refresh: bool = False,
api_version: str | None = None,
) -> list[SourceSchema]:
return build_endpoint_schemas(ENDPOINTS, INCREMENTAL_FIELDS, names)
def validate_credentials(
self,
config: DebugbearSourceConfig,
team_id: int,
schema_name: Optional[str] = None,
api_version: str | None = None,
) -> tuple[bool, str | None]:
return validate_debugbear_credentials(config.api_key)
def source_for_pipeline(self, config: DebugbearSourceConfig, inputs: SourceInputs) -> SourceResponse:
return debugbear_source(
api_key=config.api_key,
endpoint=inputs.schema_name,
should_use_incremental_field=inputs.should_use_incremental_field,
db_incremental_field_last_value=inputs.db_incremental_field_last_value
if inputs.should_use_incremental_field
else None,
)
@property
def get_source_config(self) -> SourceConfig:
return SourceConfig(
name=ExternalDataSourceType.DEBUGBEAR,
category=DataWarehouseSourceCategory.ENGINEERING___MONITORING,
label="DebugBear",
caption="Sync DebugBear's monitored projects and synthetic Lighthouse / Core Web Vitals test results into your warehouse.",
docsUrl="https://posthog.com/docs/cdp/sources/debugbear",
iconPath="/static/services/debugbear.png",
releaseStatus=ReleaseStatus.GA,
keywords=["core web vitals", "lighthouse", "web performance"],
fields=cast(
list[FieldType],
[
SourceFieldInputConfig(
name="api_key",
label="API key",
type=SourceFieldInputConfigType.PASSWORD,
required=True,
placeholder="",
secret=True,
caption="Use an Admin API key so PostHog can list every monitored project. Generate one from DebugBear's account settings — see the [API docs](https://www.debugbear.com/docs/api).",
),
],
),
)