diff --git a/docs/cloud/introduction.mdx b/docs/cloud/introduction.mdx index e593ff0b6..96d6a6f1d 100644 --- a/docs/cloud/introduction.mdx +++ b/docs/cloud/introduction.mdx @@ -6,15 +6,13 @@ icon: "cloud" **Elementary is a data observability platform tailored for dbt-first data organizations.** -The unique dbt-native architecture seamlessly integrates into engineers' workflows, ensuring ease of use and smooth adoption. +The unique dbt-native architecture seamlessly integrates into engineers' workflows, ensuring ease of use and smooth adoption. The platform provides out-of-the-box monitoring for critical issues, tools to effortlessly increase coverage, and integrations for end-to-end visibility across the data stack. Elementary promotes ownership and collaboration on incidents, and enables the whole data organization to take an active role in the data quality process. By automatically measuring and tracking data health, it helps teams transition from reactive firefighting to proactively communicating data health to consumers and stakeholders. - - - + ## Cloud Platform Features @@ -27,18 +25,11 @@ By automatically measuring and tracking data health, it helps teams transition f Our product is designed with [Security and Privacy](/cloud/general/security-and-privacy) in mind. -**SOC 2 certification:** Elementary is SOC2 type II certified! + **SOC 2 certification:** Elementary is SOC2 type II certified! +## How to Start? -## How to Start? - - + - \ No newline at end of file + \ No newline at end of file diff --git a/docs/features/ci.mdx b/docs/features/ci.mdx index 588ea4df6..236a35c5c 100644 --- a/docs/features/ci.mdx +++ b/docs/features/ci.mdx @@ -12,17 +12,12 @@ When making changes to your data project, it can sometimes be hard to fully unde Our impact analysis will run on every pull request in your dbt project, so that you can see the downstream impact of your changes. You'll also be able to see if any of your dbt tests are failing or your models aren't being built successfully. - +![](/pics/cloud/pr_impact_example.png) Elementary CI automations help you make changes with confidence by providing a comprehensive view before merging your pull request. ## Want to join the beta? - - + + + \ No newline at end of file diff --git a/docs/guides/modules-overview/dbt-package.mdx b/docs/guides/modules-overview/dbt-package.mdx index 29a8c7cc7..18ce093a8 100644 --- a/docs/guides/modules-overview/dbt-package.mdx +++ b/docs/guides/modules-overview/dbt-package.mdx @@ -8,8 +8,9 @@ To gain the most value from the dbt package, we recommend using it with the [Ele **What brings you here?** -- **An organizational data quality initiative** (e.g., platform refactoring, governance projects, or AI/ML adoption): The Elementary Cloud Platform offers pipeline monitoring, incident management, lineage tracking, dashboards, health scores, and alerts, empowering data engineers, analytics engineers, and data analysts to resolve issues efficiently and deliver trusted data products. Learn more about the [Elementary Cloud Platform](/cloud/introduction) or [book a demo](https://cal.com/maayansa/elementary-intro-docs). -- **Individual-use observability:** If you’ll be the primary user, try the open-source CLI tool to send Slack alerts, and self-host the Elementary report. +* **An organizational data quality initiative** (e.g., platform refactoring, governance projects, or AI/ML adoption): The Elementary Cloud Platform offers pipeline monitoring, incident management, lineage tracking, dashboards, health scores, and alerts, empowering data engineers, analytics engineers, and data analysts to resolve issues efficiently and deliver trusted data products. Learn more about the [Elementary Cloud Platform](/cloud/introduction) or [book a demo](https://meetings-eu1.hubspot.com/joost-boonzajer-flaes/intro-call-docs). + +* **Individual-use observability:** If you’ll be the primary user, try the open-source CLI tool to send Slack alerts, and self-host the Elementary report. The repository and source code of the Elementary dbt package can be [found here](https://github.com/elementary-data/dbt-data-reliability). @@ -21,26 +22,25 @@ Additionally, it offers a wide range of tests, including anomalies in volume, fr The impact of the package on **`dbt run`** is minimal, and most of the processing happens as part of the data tests that are executed on **`dbt test`**. - -A dbt package is additional Jinja and SQL code that is added to your project, for additional functionality. In fact, each package is a dbt project. By adding a package to your project, you are adding the package code to be part of your project, you can reference its macros, execute its models, and so on. - -Add packages to your project by creating a `packages.yml` file under the main project directory (where your ` -dbt_project.yml` is), and adding the relevant package. After you add a new package, run `dbt deps` to actually pull its -code to your project. This is also how you update packages. -Some packages we recommend you check out: [dbt_utils](https://github.com/dbt-labs/dbt-utils/tree/0.8.2/) -, [dbt_date](https://github.com/calogica/dbt-date/tree/0.5.4/) -, [codegen](https://github.com/dbt-labs/dbt-codegen/tree/0.5.0/). - + A dbt package is additional Jinja and SQL code that is added to your project, for additional functionality. In fact, each package is a dbt project. By adding a package to your project, you are adding the package code to be part of your project, you can reference its macros, execute its models, and so on. + + Add packages to your project by creating a `packages.yml` file under the main project directory (where your ` + dbt_project.yml` is), and adding the relevant package. After you add a new package, run `dbt deps` to actually pull its + code to your project. This is also how you update packages. + Some packages we recommend you check out: [dbt\_utils](https://github.com/dbt-labs/dbt-utils/tree/0.8.2/) + , [dbt\_date](https://github.com/calogica/dbt-date/tree/0.5.4/) + , [codegen](https://github.com/dbt-labs/dbt-codegen/tree/0.5.0/). - After you deploy the dbt package, you can use Elementary tests, and your dbt artifacts will be uploaded automatically with on-run-end hooks: - - - + + + + + Although you can use the package only, we recommend using it with Elementary Cloud or OSS. @@ -63,4 +63,4 @@ the following var: ```yaml vars: elementary_full_refresh: true -``` +``` \ No newline at end of file diff --git a/docs/introduction.mdx b/docs/introduction.mdx index 8bd67abcd..c58bdb49c 100644 --- a/docs/introduction.mdx +++ b/docs/introduction.mdx @@ -5,15 +5,10 @@ description: "dbt-native data observability platform built for data and analytic icon: "fire" --- -
- Elementary banner + Elementary banner
- Elementary includes two products: @@ -28,16 +23,14 @@ See the [detailed comparison](/overview/cloud-vs-oss) between Elementary and Ele Or - Start with [Elementary Community](/oss/quickstart/quickstart-cli-package), open-source CLI tool you can deploy and orchestrate to send Slack alerts and self-host the Elementary report. - ## Why choose Elementary? - Elementary configuration is managed in your dbt code. + Elementary configuration is managed in your dbt code. Elementary Cloud syncs configuration changes from the UI back to the dbt project code repository. You won't need to duplicate configuration - all your existing tests, owners, tags, and descriptions are leveraged. - @@ -46,26 +39,17 @@ Or - Start with [Elementary Community](/oss/quickstart/quickstart-cli-package), The dbt package creates a schema for logs, results and metadata, and Elementary only requires access to the Elementary schema. [Read about Security and Privacy >>>](/cloud/general/security-and-privacy) - Elementary dbt package automatically collects results and artifacts from your dbt project. All of your Elementary configuration is managed in your dbt code. By combining the package and Elementary Cloud, you get full dbt observability. All your tests and results in one dashboard and interface. - - - ## Want to know more? - - + + + \ No newline at end of file diff --git a/docs/mint.json b/docs/mint.json index 14893e524..b96ac5f2a 100644 --- a/docs/mint.json +++ b/docs/mint.json @@ -47,7 +47,7 @@ { "name": "Book a Demo", "icon": "calendar-check", - "url": "https://cal.com/maayansa/elementary-intro-docs" + "url": "https://meetings-eu1.hubspot.com/joost-boonzajer-flaes/intro-call-docs" }, { "name": "Join Slack", @@ -519,4 +519,4 @@ "destination": "/features/collaboration-and-communication/data-observability-dashboard" } ] -} +} \ No newline at end of file diff --git a/docs/oss/oss-introduction.mdx b/docs/oss/oss-introduction.mdx index f66dfae97..dc90d9b67 100644 --- a/docs/oss/oss-introduction.mdx +++ b/docs/oss/oss-introduction.mdx @@ -11,7 +11,7 @@ To gain the most value from Elementary, we recommend using the [Elementary Cloud ### Elementary OSS vs Elementary Cloud Platform * **Elementary Cloud Platform** - **Recommended for organizational data quality initiatives** (e.g., platform refactoring, governance projects, or AI/ML adoption). - The Elementary Cloud Platform offers pipeline monitoring, incident management, column level lineage, dashboards, health scores, and alerts. It empowers data engineers, analytics engineers, and data analysts to collaborate, resolve issues efficiently, and deliver trusted data products. Learn more about the [Elementary Cloud Platform](/cloud/introduction) or [book a demo](https://cal.com/maayansa/elementary-intro-docs). + The Elementary Cloud Platform offers pipeline monitoring, incident management, column level lineage, dashboards, health scores, and alerts. It empowers data engineers, analytics engineers, and data analysts to collaborate, resolve issues efficiently, and deliver trusted data products. Learn more about the [Elementary Cloud Platform](/cloud/introduction) or [book a demo](https://meetings-eu1.hubspot.com/joost-boonzajer-flaes/intro-call-docs). * **Elementary OSS** - **Recommended for local or individual use.** The CLI tool is used to send Slack alerts, and self-host the Elementary report. It is the right choice if you’ll be the primary user of Elementary and don't have collaboration needs. Learn more about the CLI tool below. diff --git a/docs/overview/cloud-vs-oss.mdx b/docs/overview/cloud-vs-oss.mdx index b211b676c..60957fab7 100644 --- a/docs/overview/cloud-vs-oss.mdx +++ b/docs/overview/cloud-vs-oss.mdx @@ -1,63 +1,59 @@ --- -title: "Elementary: Community vs Cloud" +title: "Elementary: Community vs. Cloud" sidebarTitle: "Cloud vs OSS" -description: Detailed comparison of Elementary product offerings. +description: "Detailed comparison of Elementary product offerings." icon: "list-check" --- ### Elementary Cloud + Ideal for teams monitoring mission-critical data pipelines, requiring guaranteed uptime and reliability, short-time-to-value, advanced features, collaboration, and professional support. The solution is secure by design, and requires no access to your data from cloud. ### Elementary OSS + An open-source CLI tool you can deploy and orchestrate to send Slack alerts and self-host the Elementary report. It is best for data and analytics engineers that require basic observability capabilities or for evaluating features without vendor approval. ### Features comparison -| | Community (OSS) | Elmentary Cloud | -|-----------------------------------------------------------------------|:-------------------:|:-----------------:| -| **Data monitoring and detection** | | | -| Automated freshness, volume
and schema monitors | ❌ | ✅ | -| In-pipeline data tests (via dbt) | ✅ | ✅ | -| Data anomaly detection | ✅ | ✅ | -| Custom SQL tests | ✅ | ✅ | -| Jobs performance and run results | ✅ | ✅ | -| Monitored data sets | dbt only | All tables | -| **Root cause and impact analysis** | | | -| Table-level lineage | ✅ | ✅ | -| Column-level lineage | ❌ | ✅ | -| Lineage to BI tools | ❌ | ✅ | -| **Coverage and configuration** | | | -| Configuration as code (dbt YAML) | ✅ | ✅ | -| Add tests from UI | ❌ | ✅ | -| 🚧 *Auto-tune configurations
for improved accuracy* | ❌ | ✅ | -| 🚧 *Automated test recommendations* | ❌ | ✅ | -| **Communication and collaboration** | | | -| Slack and MS Teams alerts | ✅ | ✅ | -| Alert distribution rules, multiple
destinations, custom formats | ❌ | ✅ | -| Additional alert destinations:
PagerDuty, OpsGenie, Webhook | ❌ | ✅ | -| Alert actions | ❌ | ✅ | -| Data catalog | ❌ | ✅ | -| Data Health Scores | ❌ | ✅ | -| Incident management | ❌ | ✅ | -| **Deployment, security and service** | | | -| Deployment | Self hosted, CLI | Cloud service | -| Multiple environments and data warehouses | ❌ | ✅ | -| Secure by design -
Elementary has no access to raw data | ❌ | ✅ | -| Managed service - 99.9% uptime,
no maintenance | ❌ | ✅ | -| Social login with Google | ❌ | ✅ | -| SSO using OKTA / OneLogin / AD | ❌ | ✅ | -| Custom deployment options | ❌ | ✅ | -| Role based access control | ❌ | ✅ | -| Support SLA | Community support | 24 hours SLA | - +| | Community (OSS) | Elementary Cloud | +| ---------------------------------------------------------------------- | :---------------: | :--------------: | +| **Data monitoring and detection** | | | +| Automated freshness, volume
and schema monitors | ❌ | ✅ | +| In-pipeline data tests (via dbt) | ✅ | ✅ | +| Data anomaly detection | ✅ | ✅ | +| Custom SQL tests | ✅ | ✅ | +| Jobs performance and run results | ✅ | ✅ | +| Monitored data sets | dbt only | All tables | +| **Root cause and impact analysis** | | | +| Table-level lineage | ✅ | ✅ | +| Column-level lineage | ❌ | ✅ | +| Lineage to BI tools | ❌ | ✅ | +| **Coverage and configuration** | | | +| Configuration as code (dbt YAML) | ✅ | ✅ | +| Add tests from UI | ❌ | ✅ | +| 🚧 *Auto-tune configurations
for improved accuracy* | ❌ | ✅ | +| 🚧 *Automated test recommendations* | ❌ | ✅ | +| **Communication and collaboration** | | | +| Slack and MS Teams alerts | ✅ | ✅ | +| Alert distribution rules, multiple
destinations, custom formats | ❌ | ✅ | +| Additional alert destinations:
PagerDuty, OpsGenie, Webhook | ❌ | ✅ | +| Alert actions | ❌ | ✅ | +| Data catalog | ❌ | ✅ | +| Data Health Scores | ❌ | ✅ | +| Incident management | ❌ | ✅ | +| **Deployment, security and service** | | | +| Deployment | Self hosted, CLI | Cloud service | +| Multiple environments and data warehouses | ❌ | ✅ | +| Secure by design -
Elementary has no access to raw data | ❌ | ✅ | +| Managed service - 99.9% uptime,
no maintenance | ❌ | ✅ | +| Social login with Google | ❌ | ✅ | +| SSO using OKTA / OneLogin / AD | ❌ | ✅ | +| Custom deployment options | ❌ | ✅ | +| Role based access control | ❌ | ✅ | +| Support SLA | Community support | 24 hours SLA | ### Want to know more? - - + + + \ No newline at end of file