Skip to content

Commit

Permalink
Merge branch 'datahub-project:master' into master
Browse files Browse the repository at this point in the history
  • Loading branch information
anshbansal authored Jul 18, 2024
2 parents efe7f38 + 452b94f commit 3cb93d8
Show file tree
Hide file tree
Showing 58 changed files with 3,265 additions and 775 deletions.
2 changes: 1 addition & 1 deletion datahub-web-react/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@
"test": "vitest",
"generate": "graphql-codegen --config codegen.yml",
"lint": "eslint . --ext .ts,.tsx --quiet && yarn format-check && yarn type-check",
"lint-fix": "eslint '*/**/*.{ts,tsx}' --quiet --fix",
"lint-fix": "eslint '*/**/*.{ts,tsx}' --quiet --fix && yarn format",
"format-check": "prettier --check src",
"format": "prettier --write src",
"type-check": "tsc --noEmit",
Expand Down
19 changes: 14 additions & 5 deletions docs-website/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -209,11 +209,6 @@ module.exports = {
},
items: [
"docs/managed-datahub/welcome-acryl",
{
type: "doc",
id: "docs/managed-datahub/saas-slack-setup",
className: "saasOnly",
},
{
type: "doc",
id: "docs/managed-datahub/approval-workflows",
Expand Down Expand Up @@ -247,6 +242,20 @@ module.exports = {
},
],
},
{
Slack: [
{
type: "doc",
id: "docs/managed-datahub/slack/saas-slack-setup",
className: "saasOnly",
},
{
type: "doc",
id: "docs/managed-datahub/slack/saas-slack-app",
className: "saasOnly",
},
],
},
{
"Operator Guide": [
{
Expand Down
2 changes: 1 addition & 1 deletion docs/actions/actions/slack.md
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ In the next steps, we'll show you how to configure the Slack Action based on the

#### Managed DataHub

Head over to the [Configuring Notifications](../../managed-datahub/saas-slack-setup.md#configuring-notifications) section in the Managed DataHub guide to configure Slack notifications for your Managed DataHub instance.
Head over to the [Configuring Notifications](../../managed-datahub/slack/saas-slack-setup.md#configuring-notifications) section in the Managed DataHub guide to configure Slack notifications for your Managed DataHub instance.


#### Quickstart
Expand Down
2 changes: 1 addition & 1 deletion docs/incidents/incidents.md
Original file line number Diff line number Diff line change
Expand Up @@ -427,5 +427,5 @@ These notifications are also able to tag the immediate asset's owners, along wit
<img width="70%" src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/Screen-Shot-2022-03-22-at-6.46.41-PM.png"/>
</p>

To do so, simply follow the [Slack Integration Guide](docs/managed-datahub/saas-slack-setup.md) and contact your Acryl customer success team to enable the feature!
To do so, simply follow the [Slack Integration Guide](docs/managed-datahub/slack/saas-slack-setup.md) and contact your Acryl customer success team to enable the feature!

5 changes: 3 additions & 2 deletions docs/managed-datahub/managed-datahub-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,8 @@ know.
| Monitor Freshness SLAs |||
| Monitor Table Schemas |||
| Monitor Table Volume |||
| Validate Table Columns |||
| Monitor Table Column Integrity |||
| Monitor Table with Custom SQL |||
| Receive Notifications via Email & Slack |||
| Manage Data Incidents via Slack |||
| View Data Health Dashboard |||
Expand Down Expand Up @@ -115,7 +116,7 @@ Fill out
## Additional Integrations
- [Slack Integration](docs/managed-datahub/saas-slack-setup.md)
- [Slack Integration](docs/managed-datahub/slack/saas-slack-setup.md)
- [Remote Ingestion Executor](docs/managed-datahub/operator-guide/setting-up-remote-ingestion-executor.md)
- [AWS Privatelink](docs/managed-datahub/integrations/aws-privatelink.md)
- [AWS Eventbridge](docs/managed-datahub/operator-guide/setting-up-events-api-on-aws-eventbridge.md)
Expand Down
2 changes: 1 addition & 1 deletion docs/managed-datahub/observe/assertions.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ If you opt for a 3rd party tool, it will be your responsibility to ensure the as

## Alerts

Beyond the ability to see the results of the assertion checks (and history of the results) both on the physical asset’s page in the DataHub UI and as the result of DataHub API calls, you can also get notified via [slack messages](/docs/managed-datahub/saas-slack-setup.md) (DMs or to a team channel) based on your [subscription](https://youtu.be/VNNZpkjHG_I?t=79) to an assertion change event. In the future, we’ll also provide the ability to subscribe directly to contracts.
Beyond the ability to see the results of the assertion checks (and history of the results) both on the physical asset’s page in the DataHub UI and as the result of DataHub API calls, you can also get notified via [Slack messages](/docs/managed-datahub/slack/saas-slack-setup.md) (DMs or to a team channel) based on your [subscription](https://youtu.be/VNNZpkjHG_I?t=79) to an assertion change event. In the future, we’ll also provide the ability to subscribe directly to contracts.

With Acryl Observe, you can get the Assertion Change event by getting API events via [AWS EventBridge](/docs/managed-datahub/operator-guide/setting-up-events-api-on-aws-eventbridge.md) (the availability and simplicity of setup of each solution dependent on your current Acryl setup – chat with your Acryl representative to learn more).

Expand Down
113 changes: 0 additions & 113 deletions docs/managed-datahub/saas-slack-setup.md

This file was deleted.

59 changes: 59 additions & 0 deletions docs/managed-datahub/slack/saas-slack-app.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
import FeatureAvailability from '@site/src/components/FeatureAvailability';

# Slack App Features

<FeatureAvailability saasOnly />

## Overview
The DataHub Slack App brings several of DataHub's key capabilities directly into your Slack experience. These include:
1. Searching for Data Assets
2. Subscribing to notifications for Data Assets
3. Managing Data Incidents

*Our goal with the Slack app is to make data discovery easier and more accessible for you.*

## Slack App Commands
The command-based capabilities on the Slack App revolve around search.

### Querying for Assets
You can trigger a search by simplying typing `/acryl my favorite table`.
<p align="center">
<img width="70%" alt="Example of an in-Slack Acryl search command being performed." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_app_search_1.png" />
</p>

Right within Slack, you'll be presented with results matching your query, and a handful of quick-actions for your convenience.
<p align="center">
<img width="70%" alt="Example of search results being displayed within Slack." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_app_search_2.png" />
</p>

By selecting **'More Details'** you can preview in-depth information about an asset without leaving Slack.
<p align="center">
<img width="70%" alt="Example of search results being displayed within Slack." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_app_search_3.png" />
</p>

### Subscribing to be notified about an Asset
You can hit the **'Subscribe'** button on a specific search result to subscribe to it directly from within Slack.
<p align="center">
<img width="70%" alt="Example of search results being displayed within Slack." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_app_search_2.png" />
</p>


## Manage Data Incidents
Some of the most commonly used features within our Slack app are the Incidents management capabilities.
The DataHub UI offers a rich set of [Incident tracking and management](https://datahubproject.io/docs/incidents/incidents/) features.
When a Slack member or channel receives notifications about an Incident, many of these features are made accessible right within the Slack app.

When an incident is raised, you will recieve rich context about the incident in the Slack message itself. You will also be able to `Mark as Resolved`, update the `Priorty`, set a triage `Stage` and `View Details` - directly from the Slack message.
<p align="center">
<img width="70%" alt="Example of search results being displayed within Slack." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_incidents_1.png" />
</p>

If you choose to `Mark as Resolved` the message will update in-place, and you will be presented with the ability to `Reopen Incident` should you choose.
<p align="center">
<img width="70%" alt="Example of search results being displayed within Slack." src="https://raw.githubusercontent.com/datahub-project/static-assets/main/imgs/saas/slack/slack_incidents_2.png" />
</p>


## Coming Soon
We're constantly working on rolling out new features for the Slack app, stay tuned!

Loading

0 comments on commit 3cb93d8

Please sign in to comment.