acryl-datahub 1.2.0.2rc2__py3-none-any.whl → 1.2.0.3rc1__py3-none-any.whl

datahub/ingestion/source/grafana/grafana_source.py

@@ -1,131 +1,569 @@
+import logging
 from typing import Iterable, List, Optional
 
 import requests
-from pydantic import Field, SecretStr
 
-import datahub.emitter.mce_builder as builder
-from datahub.configuration.source_common import PlatformInstanceConfigMixin
+from datahub.emitter.mce_builder import (
+    make_chart_urn,
+    make_container_urn,
+    make_dashboard_urn,
+    make_data_platform_urn,
+    make_dataplatform_instance_urn,
+    make_dataset_urn_with_platform_instance,
+    make_schema_field_urn,
+    make_tag_urn,
+)
 from datahub.emitter.mcp import MetadataChangeProposalWrapper
+from datahub.emitter.mcp_builder import add_dataset_to_container, gen_containers
 from datahub.ingestion.api.common import PipelineContext
 from datahub.ingestion.api.decorators import (
+    SourceCapability,
     SupportStatus,
+    capability,
     config_class,
     platform_name,
     support_status,
 )
 from datahub.ingestion.api.source import MetadataWorkUnitProcessor
-from datahub.ingestion.api.source_helpers import auto_workunit
 from datahub.ingestion.api.workunit import MetadataWorkUnit
+from datahub.ingestion.source.common.subtypes import BIContainerSubTypes
+from datahub.ingestion.source.grafana.entity_mcp_builder import (
+    build_chart_mcps,
+    build_dashboard_mcps,
+)
+from datahub.ingestion.source.grafana.field_utils import extract_fields_from_panel
+from datahub.ingestion.source.grafana.grafana_api import GrafanaAPIClient
+from datahub.ingestion.source.grafana.grafana_config import (
+    GrafanaSourceConfig,
+)
+from datahub.ingestion.source.grafana.lineage import LineageExtractor
+from datahub.ingestion.source.grafana.models import (
+    Dashboard,
+    DashboardContainerKey,
+    Folder,
+    FolderKey,
+    Panel,
+)
+from datahub.ingestion.source.grafana.report import (
+    GrafanaSourceReport,
+)
 from datahub.ingestion.source.state.stale_entity_removal_handler import (
     StaleEntityRemovalHandler,
-    StaleEntityRemovalSourceReport,
-    StatefulIngestionConfigBase,
 )
 from datahub.ingestion.source.state.stateful_ingestion_base import (
-    StatefulIngestionReport,
     StatefulIngestionSourceBase,
 )
+from datahub.ingestion.source_report.ingestion_stage import (
+    LINEAGE_EXTRACTION,
+)
 from datahub.metadata.com.linkedin.pegasus2avro.common import ChangeAuditStamps
-from datahub.metadata.schema_classes import DashboardInfoClass, StatusClass
-
-
-class GrafanaSourceConfig(StatefulIngestionConfigBase, PlatformInstanceConfigMixin):
-    url: str = Field(
-        default="",
-        description="Grafana URL in the format http://your-grafana-instance with no trailing slash",
-    )
-    service_account_token: SecretStr = Field(
-        description="Service account token for Grafana"
-    )
+from datahub.metadata.schema_classes import (
+    DashboardInfoClass,
+    DataPlatformInstanceClass,
+    DatasetPropertiesClass,
+    DatasetSnapshotClass,
+    GlobalTagsClass,
+    InputFieldClass,
+    InputFieldsClass,
+    MetadataChangeEventClass,
+    OtherSchemaClass,
+    SchemaFieldClass,
+    SchemaMetadataClass,
+    StatusClass,
+    TagAssociationClass,
+)
 
+# Grafana-specific ingestion stages
+GRAFANA_BASIC_EXTRACTION = "Grafana Basic Dashboard Extraction"
+GRAFANA_FOLDER_EXTRACTION = "Grafana Folder Extraction"
+GRAFANA_DASHBOARD_EXTRACTION = "Grafana Dashboard Extraction"
+GRAFANA_PANEL_EXTRACTION = "Grafana Panel Extraction"
 
-class GrafanaReport(StaleEntityRemovalSourceReport):
-    pass
+logger = logging.getLogger(__name__)
 
 
 @platform_name("Grafana")
 @config_class(GrafanaSourceConfig)
-@support_status(SupportStatus.TESTING)
+@support_status(SupportStatus.CERTIFIED)
+@capability(SourceCapability.PLATFORM_INSTANCE, "Enabled by default")
+@capability(SourceCapability.DELETION_DETECTION, "Enabled by default")
+@capability(SourceCapability.LINEAGE_COARSE, "Enabled by default")
+@capability(SourceCapability.LINEAGE_FINE, "Enabled by default")
+@capability(SourceCapability.OWNERSHIP, "Enabled by default")
+@capability(SourceCapability.TAGS, "Enabled by default")
 class GrafanaSource(StatefulIngestionSourceBase):
     """
-    This is an experimental source for Grafana.
-    Currently only ingests dashboards (no charts)
+    This plugin extracts metadata from Grafana and ingests it into DataHub. It connects to Grafana's API
+    to extract metadata about dashboards, charts, and data sources. The following types of metadata are extracted:
+
+    - Container Entities:
+        - Folders: Top-level organizational units in Grafana
+        - Dashboards: Collections of panels and charts
+        - The full container hierarchy is preserved (Folders -> Dashboards -> Charts/Datasets)
+
+    - Charts and Visualizations:
+        - All panel types (graphs, tables, stat panels, etc.)
+        - Chart configuration and properties
+        - Links to the original Grafana UI
+        - Custom properties including panel types and data source information
+        - Input fields and schema information when available
+
+    - Data Sources and Datasets:
+        - Physical datasets representing Grafana's data sources
+        - Dataset schema information extracted from queries and panel configurations
+        - Support for various data source types (SQL, Prometheus, etc.)
+        - Custom properties including data source type and configuration
+
+    - Lineage Information:
+        - Dataset-level lineage showing relationships between:
+            - Source data systems and Grafana datasets
+            - Grafana datasets and charts
+        - Column-level lineage for SQL-based data sources
+        - Support for external source systems through configurable platform mappings
+
+    - Tags and Ownership:
+        - Dashboard and chart tags
+        - Ownership information derived from:
+            - Dashboard creators
+            - Technical owners based on dashboard UIDs
+            - Custom ownership assignments
+
+    The source supports the following capabilities:
+    - Platform instance support for multi-Grafana deployments
+    - Stateful ingestion with support for soft-deletes
+    - Fine-grained lineage at both dataset and column levels
+    - Automated tag extraction
+    - Support for both HTTP and HTTPS connections with optional SSL verification
     """
 
+    config: GrafanaSourceConfig
+    report: GrafanaSourceReport
+
     def __init__(self, config: GrafanaSourceConfig, ctx: PipelineContext):
         super().__init__(config, ctx)
-        self.source_config = config
-        self.report = GrafanaReport()
-        self.platform = "grafana"
+        self.config = config
+        self.ctx = ctx
+        self.platform = config.platform
+        self.platform_instance = self.config.platform_instance
+        self.env = self.config.env
+        self.report = GrafanaSourceReport()
+
+        self.api_client = GrafanaAPIClient(
+            base_url=self.config.url,
+            token=self.config.service_account_token,
+            verify_ssl=self.config.verify_ssl,
+            page_size=self.config.page_size,
+            report=self.report,
+        )
+
+        # Initialize lineage extractor with graph
+        self.lineage_extractor = None
+        if self.config.include_lineage:
+            self.lineage_extractor = LineageExtractor(
+                platform=self.config.platform,
+                platform_instance=self.config.platform_instance,
+                env=self.config.env,
+                connection_to_platform_map=self.config.connection_to_platform_map,
+                graph=self.ctx.graph,
+                report=self.report,
+                include_column_lineage=self.config.include_column_lineage,
+            )
 
     @classmethod
-    def create(cls, config_dict, ctx):
+    def create(cls, config_dict: dict, ctx: PipelineContext) -> "GrafanaSource":
         config = GrafanaSourceConfig.parse_obj(config_dict)
         return cls(config, ctx)
 
     def get_workunit_processors(self) -> List[Optional[MetadataWorkUnitProcessor]]:
-        return [
-            *super().get_workunit_processors(),
+        processors = super().get_workunit_processors()
+        processors.append(
             StaleEntityRemovalHandler.create(
-                self, self.source_config, self.ctx
-            ).workunit_processor,
-        ]
-
-    def get_report(self) -> StatefulIngestionReport:
-        return self.report
+                self, self.config, self.ctx
+            ).workunit_processor
+        )
+        return processors
 
     def get_workunits_internal(self) -> Iterable[MetadataWorkUnit]:
-        headers = {
-            "Authorization": f"Bearer {self.source_config.service_account_token.get_secret_value()}",
-            "Content-Type": "application/json",
-        }
-        try:
-            response = requests.get(
-                f"{self.source_config.url}/api/search", headers=headers
-            )
-            response.raise_for_status()
-        except requests.exceptions.RequestException as e:
-            self.report.report_failure(f"Failed to fetch dashboards: {str(e)}")
+        """Main extraction logic"""
+
+        # Check if we should use basic mode
+        if self.config.basic_mode:
+            logger.info("Running in basic mode - extracting dashboard metadata only")
+            yield from self._get_workunits_basic_mode()
             return
-        res_json = response.json()
-        for item in res_json:
-            uid = item["uid"]
-            title = item["title"]
-            url_path = item["url"]
-            full_url = f"{self.source_config.url}{url_path}"
-            dashboard_urn = builder.make_dashboard_urn(
-                platform=self.platform,
-                name=uid,
-                platform_instance=self.source_config.platform_instance,
-            )
 
-            yield from auto_workunit(
-                MetadataChangeProposalWrapper.construct_many(
+        # Enhanced mode - extract full hierarchy and details
+        yield from self._get_workunits_enhanced_mode()
+
+    def _get_workunits_basic_mode(self) -> Iterable[MetadataWorkUnit]:
+        """Basic extraction mode - only dashboard metadata (backwards compatible)"""
+        with self.report.new_stage(GRAFANA_BASIC_EXTRACTION):
+            headers = {
+                "Authorization": f"Bearer {self.config.service_account_token.get_secret_value()}",
+                "Content-Type": "application/json",
+            }
+
+            try:
+                response = requests.get(
+                    f"{self.config.url}/api/search",
+                    headers=headers,
+                    verify=self.config.verify_ssl,
+                )
+                response.raise_for_status()
+            except requests.exceptions.RequestException as e:
+                self.report.report_failure(
+                    title="Dashboard Search Error",
+                    message="Failed to fetch dashboards in basic mode",
+                    context=str(e),
+                    exc=e,
+                )
+                return
+
+            dashboards = response.json()
+
+            for item in dashboards:
+                if not self.config.dashboard_pattern.allowed(item.get("title", "")):
+                    continue
+
+                uid = item["uid"]
+                title = item["title"]
+                url_path = item["url"]
+                full_url = f"{self.config.url}{url_path}"
+
+                dashboard_urn = make_dashboard_urn(
+                    platform=self.platform,
+                    name=uid,
+                    platform_instance=self.platform_instance,
+                )
+
+                # Create basic dashboard info
+                dashboard_info = DashboardInfoClass(
+                    description="",
+                    title=title,
+                    charts=[],
+                    lastModified=ChangeAuditStamps(),
+                    externalUrl=full_url,
+                    customProperties={
+                        key: str(value)
+                        for key, value in {
+                            "displayName": title,
+                            "id": item["id"],
+                            "uid": uid,
+                            "title": title,
+                            "uri": item["uri"],
+                            "type": item["type"],
+                            "folderId": item.get("folderId"),
+                            "folderUid": item.get("folderUid"),
+                            "folderTitle": item.get("folderTitle"),
+                        }.items()
+                        if value is not None
+                    },
+                )
+
+                # Yield dashboard workunit
+                yield MetadataChangeProposalWrapper(
                     entityUrn=dashboard_urn,
-                    aspects=[
-                        DashboardInfoClass(
-                            description="",
-                            title=title,
-                            charts=[],
-                            lastModified=ChangeAuditStamps(),
-                            externalUrl=full_url,
-                            customProperties={
-                                key: str(value)
-                                for key, value in {
-                                    "displayName": title,
-                                    "id": item["id"],
-                                    "uid": uid,
-                                    "title": title,
-                                    "uri": item["uri"],
-                                    "type": item["type"],
-                                    "folderId": item.get("folderId"),
-                                    "folderUid": item.get("folderUid"),
-                                    "folderTitle": item.get("folderTitle"),
-                                }.items()
-                                if value is not None
-                            },
-                        ),
-                        StatusClass(removed=False),
-                    ],
+                    aspect=dashboard_info,
+                ).as_workunit()
+
+                yield MetadataChangeProposalWrapper(
+                    entityUrn=dashboard_urn,
+                    aspect=StatusClass(removed=False),
+                ).as_workunit()
+
+                self.report.report_dashboard_scanned()
+
+    def _get_workunits_enhanced_mode(self) -> Iterable[MetadataWorkUnit]:
+        """Enhanced extraction mode - full hierarchy, panels, and lineage"""
+        # Process folders first
+        with self.report.new_stage(GRAFANA_FOLDER_EXTRACTION):
+            for folder in self.api_client.get_folders():
+                if self.config.folder_pattern.allowed(folder.title):
+                    self.report.report_folder_scanned()
+                    yield from self._process_folder(folder)
+
+        # Process dashboards
+        with self.report.new_stage(GRAFANA_DASHBOARD_EXTRACTION):
+            for dashboard in self.api_client.get_dashboards():
+                if self.config.dashboard_pattern.allowed(dashboard.title):
+                    self.report.report_dashboard_scanned()
+                    yield from self._process_dashboard(dashboard)
+
+    def _process_folder(self, folder: Folder) -> Iterable[MetadataWorkUnit]:
+        """Process Grafana folder metadata"""
+        folder_key = FolderKey(
+            platform=self.config.platform,
+            instance=self.config.platform_instance,
+            folder_id=folder.id,
+        )
+
+        yield from gen_containers(
+            container_key=folder_key,
+            name=folder.title,
+            sub_types=[BIContainerSubTypes.LOOKER_FOLDER],
+            description=folder.description,
+        )
+
+    def _process_dashboard(self, dashboard: Dashboard) -> Iterable[MetadataWorkUnit]:
+        """Process dashboard and its panels"""
+        chart_urns = []
+
+        # First create the dashboard container
+        dashboard_container_key = DashboardContainerKey(
+            platform=self.config.platform,
+            instance=self.config.platform_instance,
+            dashboard_id=dashboard.uid,
+            folder_id=dashboard.folder_id,
+        )
+
+        # Generate dashboard container first
+        yield from gen_containers(
+            container_key=dashboard_container_key,
+            name=dashboard.title,
+            sub_types=[BIContainerSubTypes.GRAFANA_DASHBOARD],
+            description=dashboard.description,
+        )
+
+        # If dashboard is in a folder, add it to folder container
+        if dashboard.folder_id:
+            folder_key = FolderKey(
+                platform=self.config.platform,
+                instance=self.config.platform_instance,
+                folder_id=dashboard.folder_id,
+            )
+
+            yield from add_dataset_to_container(
+                container_key=folder_key,
+                dataset_urn=make_container_urn(dashboard_container_key),
+            )
+
+        # Process all panels first
+        with self.report.new_stage(GRAFANA_PANEL_EXTRACTION):
+            for panel in dashboard.panels:
+                self.report.report_chart_scanned()
+
+                # First emit the dataset for each panel's datasource
+                yield from self._process_panel_dataset(
+                    panel, dashboard.uid, self.config.ingest_tags
+                )
+
+                # Create chart MCE
+                dataset_urn, chart_urn, chart_mcps = build_chart_mcps(
+                    panel=panel,
+                    dashboard=dashboard,
+                    platform=self.config.platform,
+                    platform_instance=self.config.platform_instance,
+                    env=self.config.env,
+                    base_url=self.config.url,
+                    ingest_tags=self.config.ingest_tags,
                 )
+                chart_urns.append(chart_urn)
+
+                for mcp in chart_mcps:
+                    yield mcp.as_workunit()
+
+                # Add chart to dashboard container
+                chart_urn = make_chart_urn(
+                    self.platform,
+                    f"{dashboard.uid}.{panel.id}",
+                    self.platform_instance,
+                )
+                if dataset_urn:
+                    input_fields = extract_fields_from_panel(
+                        panel,
+                        self.config.connection_to_platform_map,
+                        self.ctx.graph,
+                        self.report,
+                    )
+                    if input_fields:
+                        yield from self._add_input_fields_to_chart(
+                            chart_urn=chart_urn,
+                            dataset_urn=dataset_urn,
+                            input_fields=input_fields,
+                        )
+
+                yield from add_dataset_to_container(
+                    container_key=dashboard_container_key,
+                    dataset_urn=chart_urn,
+                )
+
+        # Process lineage extraction
+        if self.config.include_lineage and self.lineage_extractor:
+            with self.report.new_stage(LINEAGE_EXTRACTION):
+                for panel in dashboard.panels:
+                    # Process lineage
+                    try:
+                        lineage = self.lineage_extractor.extract_panel_lineage(panel)
+                        if lineage:
+                            yield lineage.as_workunit()
+                            self.report.report_lineage_extracted()
+                        else:
+                            self.report.report_no_lineage()
+                    except Exception as e:
+                        logger.warning(
+                            f"Failed to extract lineage for panel {panel.id}: {e}"
+                        )
+                        self.report.report_lineage_extraction_failure()
+
+        # Create dashboard MCPs
+        dashboard_urn, dashboard_mcps = build_dashboard_mcps(
+            dashboard=dashboard,
+            platform=self.config.platform,
+            platform_instance=self.config.platform_instance,
+            chart_urns=chart_urns,
+            base_url=self.config.url,
+            ingest_owners=self.config.ingest_owners,
+            ingest_tags=self.config.ingest_tags,
+        )
+
+        # Add each dashboard MCP as a work unit
+        for mcp in dashboard_mcps:
+            yield mcp.as_workunit()
+
+        # Add dashboard entity to its container
+        yield from add_dataset_to_container(
+            container_key=dashboard_container_key,
+            dataset_urn=dashboard_urn,
+        )
+
+    def _add_dashboard_to_folder(
+        self, dashboard: Dashboard
+    ) -> Iterable[MetadataWorkUnit]:
+        """Add dashboard to folder container"""
+        folder_key = FolderKey(
+            platform=self.config.platform,
+            instance=self.config.platform_instance,
+            folder_id=str(dashboard.folder_id),
+        )
+
+        dashboard_key = DashboardContainerKey(
+            platform=self.config.platform,
+            instance=self.config.platform_instance,
+            dashboard_id=dashboard.uid,
+            folder_id=dashboard.folder_id,
+        )
+
+        yield from add_dataset_to_container(
+            container_key=folder_key,
+            dataset_urn=dashboard_key.as_urn(),
+        )
+
+    def _add_input_fields_to_chart(
+        self, chart_urn: str, dataset_urn: str, input_fields: List[SchemaFieldClass]
+    ) -> Iterable[MetadataWorkUnit]:
+        """Add input fields aspect to chart"""
+        if not input_fields:
+            return
+
+        yield MetadataChangeProposalWrapper(
+            entityUrn=chart_urn,
+            aspect=InputFieldsClass(
+                fields=[
+                    InputFieldClass(
+                        schemaField=field,
+                        schemaFieldUrn=make_schema_field_urn(
+                            dataset_urn, field.fieldPath
+                        ),
+                    )
+                    for field in input_fields
+                ]
+            ),
+        ).as_workunit()
+
+    def _process_panel_dataset(
+        self, panel: Panel, dashboard_uid: str, ingest_tags: bool
+    ) -> Iterable[MetadataWorkUnit]:
+        """Process dataset metadata for a panel"""
+        if not panel.datasource_ref:
+            self.report.report_datasource_warning()
+            return
+
+        ds_type = panel.datasource_ref.type or "unknown"
+        ds_uid = panel.datasource_ref.uid or "unknown"
+
+        # Track datasource warnings for unknown types
+        if ds_type == "unknown" or ds_uid == "unknown":
+            self.report.report_datasource_warning()
+
+        # Build dataset name
+        dataset_name = f"{ds_type}.{ds_uid}.{panel.id}"
+
+        # Create dataset URN
+        dataset_urn = make_dataset_urn_with_platform_instance(
+            platform=self.platform,
+            name=dataset_name,
+            platform_instance=self.platform_instance,
+            env=self.env,
+        )
+
+        # Create dataset snapshot
+        dataset_snapshot = DatasetSnapshotClass(
+            urn=dataset_urn,
+            aspects=[
+                DataPlatformInstanceClass(
+                    platform=make_data_platform_urn(self.platform),
+                    instance=make_dataplatform_instance_urn(
+                        platform=self.platform,
+                        instance=self.platform_instance,
+                    )
+                    if self.platform_instance
+                    else None,
+                ),
+                DatasetPropertiesClass(
+                    name=f"{ds_uid} ({panel.title or panel.id})",
+                    description="",
+                    customProperties={
+                        "type": ds_type,
+                        "uid": ds_uid,
+                        "full_path": dataset_name,
+                    },
+                ),
+                StatusClass(removed=False),
+            ],
+        )
+
+        # Add schema metadata if available
+        schema_fields = extract_fields_from_panel(
+            panel, self.config.connection_to_platform_map, self.ctx.graph, self.report
+        )
+        if schema_fields:
+            schema_metadata = SchemaMetadataClass(
+                schemaName=f"{ds_type}.{ds_uid}.{panel.id}",
+                platform=make_data_platform_urn(self.platform),
+                version=0,
+                fields=schema_fields,
+                hash="",
+                platformSchema=OtherSchemaClass(rawSchema=""),
             )
+            dataset_snapshot.aspects.append(schema_metadata)
+
+        if dashboard_uid and self.config.ingest_tags:
+            dashboard = self.api_client.get_dashboard(dashboard_uid)
+            if dashboard and dashboard.tags:
+                tags = []
+                for tag in dashboard.tags:
+                    tags.append(TagAssociationClass(tag=make_tag_urn(tag)))
+
+                if tags:
+                    dataset_snapshot.aspects.append(GlobalTagsClass(tags=tags))
+
+        self.report.report_dataset_scanned()
+        yield MetadataWorkUnit(
+            id=f"grafana-dataset-{ds_uid}-{panel.id}",
+            mce=MetadataChangeEventClass(proposedSnapshot=dataset_snapshot),
+        )
+
+        # Add dataset to dashboard container
+        if dashboard_uid:
+            dashboard_key = DashboardContainerKey(
+                platform=self.platform,
+                instance=self.platform_instance,
+                dashboard_id=dashboard_uid,
+            )
+            yield from add_dataset_to_container(
+                container_key=dashboard_key,
+                dataset_urn=dataset_urn,
+            )
+
+    def get_report(self) -> GrafanaSourceReport:
+        return self.report