Skip to main content

Getting Started: Day 1

Get started with your OpenMetadata service in a few simple steps:
  1. Set up a Data Connector: Connect your data sources to begin collecting metadata.
  2. Ingest Metadata: Run the metadata ingestion process to gather and push data insights.
  3. Invite Users: Add team members to collaborate and manage metadata together.
  4. Explore the Features: Dive into OpenMetadata’s extensive feature set to unlock the full potential of your data.
Ready to begin? Let’s get started!

Step 1: Set up a Data Connector

Once you have logged into your OpenMetadata instance, set up a data connector to start ingesting metadata. OpenMetadata provides 90+ turnkey connectors for a wide range of services, including:
  • Databases
  • Dashboards
  • Messaging services
  • Pipelines
  • ML models
  • Storage services
  • Other metadata services
For custom data sources, metadata ingestion can also be set up via API. There’s two options on how to set up a data connector:
  1. Run the connector in OpenMetadata: In this scenario, an IP will be provided when you add the service. You must allow access to this IP in your data sources.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-discovery.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=990d6747d11e65992b3f3bcaa331833f

Run the connector in OpenMetadata

Guide to start ingesting metadata seamlessly from your data sources.
  1. Run the connector in your infrastructure or on a local machine:: This hybrid model allows organizations to run metadata ingestion components within their own infrastructure. This ensures that OpenMetadata’s managed service doesn’t need direct access to the underlying data. Only metadata is collected locally and securely transmitted to the platform, maintaining data privacy and security.

Step 2: Ingest Metadata

Once the connector is set up, configure a metadata ingestion pipeline to import metadata into OpenMetadata on a regular schedule.
  • Navigate to Settings > Services > Databases and select the service you added.
Ingestion Navigation
  • Go to the Agents tab and click Add Metadata Agent.
Adding Ingestion
  • Configure any required settings or filters for the ingestion process. Documentation is available in the side panel for reference.
Configure Ingestion
  • Schedule the pipeline to ingest metadata at regular intervals.
Schedule Ingestion
  • In addition to metadata ingestion, you can set up pipelines for lineage, profiler data, or dbt information.
  • Once the metadata ingestion is completed, the ingested data assets can be viewed under the Explore section in the main menu.
Ingested Data
  • You can repeat these steps to ingest metadata from other data sources as needed.

Step 3: Invite Users After Setting Up SMTP

SMTP Configuration

To invite users you will need to ensure that you have an SMTP server available. With the information for your SMTP server you can configure OpenMetadata to send email alerts by updating the details from the UI. To update the details from the UI, navigate to Settings > Preferences > Email Email Configuration
If you encounter issues connecting to the SMTP server, ensure that the correct Certificate Authority (CA) is configured to trust the SMTP host. Additionally, use the DNS hostname instead of the IP address in the SMTP server endpoint configuration to avoid certificate validation errors.

Inviting Users

After metadata has been ingested into OpenMetadata, you can invite users to collaborate on the data and assign different roles.
  • Go to Settings > Team & User Management > Users.
Users Navigation
  • Click Add User, then enter their email and other required details to grant access to the platform.
Adding New User
  • Organize users into different Teams, and assign them specific Roles.
  • Users inherit access permissions from their assigned teams and roles.
  • Admin access can be granted to users who need full access to all settings, including the ability to invite new users.
Users Profile
  • New users will receive an email invitation to set up their accounts.

Step 4: Explore Features of OpenMetadata

OpenMetadata offers a comprehensive platform for data teams to:
  • Break down data silos
  • Securely share data assets across various sources
  • Foster collaboration around trusted data
  • Establish a documentation-first data culture within your organization
Explore these features and unlock the full potential of your data using OpenMetadata.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-discovery.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=990d6747d11e65992b3f3bcaa331833f

Data Discovery

Discover the right data assets to make timely business decisions.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-collaboration.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=9177ffcfcb5b41c7052818ea36c6941e

Data Collaboration

Foster data team collaboration to enhance data understanding.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-quality.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=0e23ba7f424f1a7ab5d25efb00ddbd06

Data Quality & Observability

Trust your data with quality tests & monitor the health of your data systems.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-lineage.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=263d9a4c554a7b1fefc5ce8732d1768f

Data Lineage

Trace the path of data across tables, pipelines, and dashboards.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-insights.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=c8518bc5bdaf438db7644375ff5a5f09

Data Insights

Define KPIs and set goals to proactively hone the data culture of your company.
https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/data-governance.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=3af29039bf2c626bd6f763fb81757a33

Data Governance

Enhance your data platform governance using OpenMetadata.

Deep Dive into OpenMetadata: Guides for Admins and Data Users

https://mintcdn.com/openmetadata/4oHMcq4H3LdkBOt_/public/images/icons/administration.svg?fit=max&auto=format&n=4oHMcq4H3LdkBOt_&q=85&s=e65ea2319ea385c76ebd37ec8cfaac5e

Admin Guide

Admin users can get started with OpenMetadata with just three quick and easy steps & know-it-all with the advanced guides.
https://mintcdn.com/openmetadata/Z_Ib-0g05fLykSep/public/images/icons/steward.svg?fit=max&auto=format&n=Z_Ib-0g05fLykSep&q=85&s=e416e0d067159ab06bc03dd11706a5c7

Guide for Data Users

Get to know the basics of OpenMetadata and about the data assets that you can explore in the all-in-one platform.