From c2acd15d786de0e306fc1719d017b585d7f292de Mon Sep 17 00:00:00 2001 From: David Young <156974579+DYTechWriter@users.noreply.github.com> Date: Wed, 10 Jun 2026 00:05:38 +0000 Subject: [PATCH] docs: add assumption-free introductions to integration pages (8 of 29) Part of #339. Adds 1-2 sentence tool descriptions before the Mission Control sentence on each integration landing page, so visitors arriving directly (e.g. via search) have context without needing to read the overview page first. Also fixes Clickhouse -> ClickHouse capitalisation (x12) and 'configuration items' -> 'config items' in clickhouse.mdx. --- mission-control/docs/integrations/argo.mdx | 2 +- .../docs/integrations/azure-devops.mdx | 2 +- mission-control/docs/integrations/azure.mdx | 2 +- .../docs/integrations/clickhouse.mdx | 26 +++++++++---------- mission-control/docs/integrations/github.mdx | 2 +- .../docs/integrations/kubernetes/index.mdx | 2 +- .../docs/integrations/prometheus.mdx | 2 +- mission-control/docs/integrations/slack.mdx | 2 +- 8 files changed, 20 insertions(+), 20 deletions(-) diff --git a/mission-control/docs/integrations/argo.mdx b/mission-control/docs/integrations/argo.mdx index 61de2964..5355cc7a 100644 --- a/mission-control/docs/integrations/argo.mdx +++ b/mission-control/docs/integrations/argo.mdx @@ -14,7 +14,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with ArgoCD to provide visibility into your GitOps deployments. +ArgoCD is a declarative GitOps continuous delivery tool for Kubernetes that keeps your cluster in sync with application definitions stored in Git. Mission Control integrates with ArgoCD to track sync status, resource health, and changes across your GitOps deployments. ## Quick Start diff --git a/mission-control/docs/integrations/azure-devops.mdx b/mission-control/docs/integrations/azure-devops.mdx index 17c5bd1a..db720835 100644 --- a/mission-control/docs/integrations/azure-devops.mdx +++ b/mission-control/docs/integrations/azure-devops.mdx @@ -13,7 +13,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with Azure DevOps to monitor pipelines and trigger builds. +Azure DevOps is Microsoft's suite of developer services covering planning, source control, CI/CD pipelines, testing, and artifact management. Mission Control integrates with Azure DevOps to monitor pipeline health, trigger builds from playbooks, and catalog your DevOps resources. --- diff --git a/mission-control/docs/integrations/azure.mdx b/mission-control/docs/integrations/azure.mdx index f037095c..a9f83540 100644 --- a/mission-control/docs/integrations/azure.mdx +++ b/mission-control/docs/integrations/azure.mdx @@ -11,7 +11,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with Azure to provide visibility into your cloud infrastructure. +Microsoft Azure is a cloud platform offering over 200 services across compute, storage, networking, databases, and more. Mission Control integrates with Azure to discover and catalog your cloud resources, tracking configuration changes and relationships across subscriptions and resource groups. --- diff --git a/mission-control/docs/integrations/clickhouse.mdx b/mission-control/docs/integrations/clickhouse.mdx index 69b7e0ca..8eac63d4 100644 --- a/mission-control/docs/integrations/clickhouse.mdx +++ b/mission-control/docs/integrations/clickhouse.mdx @@ -1,5 +1,5 @@ --- -title: Clickhouse +title: ClickHouse sidebar_custom_props: icon: clickhouse --- @@ -12,11 +12,11 @@ import Icon from '@site/../common/src/components/Icon' -Mission Control integrates with Clickhouse to scrape configuration data from databases and cloud storage. +ClickHouse is a fast, open-source column-oriented database optimized for real-time analytical queries on large datasets, with native support for querying data in S3, GCS, and Azure Blob Storage. Mission Control integrates with ClickHouse to scrape configuration data from databases and cloud storage into the catalog. **Use cases:** -- Import configuration items from Clickhouse tables and queries +- Import config items from ClickHouse tables and queries - Query data from AWS S3, Google Cloud Storage, and Azure Blob Storage - Process CSV, JSON, Parquet, and Iceberg file formats - Track changes in analytical data and business configurations @@ -24,11 +24,11 @@ Mission Control integrates with Clickhouse to scrape configuration data from dat ## Data Sources -Clickhouse's powerful SQL engine can query data from multiple sources using [table functions](https://clickhouse.com/docs/en/sql-reference/table-functions): +ClickHouse's powerful SQL engine can query data from multiple sources using [table functions](https://clickhouse.com/docs/en/sql-reference/table-functions): | Source | Description | Use Cases | |--------|-------------|-----------| -| **Clickhouse Database** | Direct connection to Clickhouse tables and materialized views | Application configs, CDC tables, analytics data | +| **ClickHouse Database** | Direct connection to ClickHouse tables and materialized views | Application configs, CDC tables, analytics data | | **AWS S3** | Query objects from S3 buckets using the `s3()` function | Data lake exports, CloudTrail logs, cost reports | | **Google Cloud Storage** | Query objects from GCS buckets using the `gcs()` function | BigQuery exports, Dataflow outputs, backup configs | | **Azure Blob Storage** | Query blobs from Azure containers using `azureBlobStorage()` | Data Factory exports, Azure logs, Power BI datasets | @@ -39,9 +39,9 @@ Clickhouse's powerful SQL engine can query data from multiple sources using [tab -### Direct Clickhouse Connection +### Direct ClickHouse Connection -Query configuration data directly from Clickhouse tables. +Query configuration data directly from ClickHouse tables. ```yaml title="clickhouse-scraper.yaml" apiVersion: configs.flanksource.com/v1 @@ -68,7 +68,7 @@ spec:
-Query Parquet files stored in S3 using Clickhouse's S3 table function. +Query Parquet files stored in S3 using ClickHouse's S3 table function. ```yaml title="clickhouse-s3-parquet.yaml" apiVersion: configs.flanksource.com/v1 @@ -258,7 +258,7 @@ spec:
-Query configuration data from a remote MySQL database using Clickhouse's MySQL table function. +Query configuration data from a remote MySQL database using ClickHouse's MySQL table function. ```yaml title="clickhouse-mysql.yaml" apiVersion: configs.flanksource.com/v1 @@ -438,7 +438,7 @@ spec: ## Deployment -Mission Control can deploy a Clickhouse instance for you: +Mission Control can deploy a ClickHouse instance for you: ```yaml # values.yaml @@ -447,13 +447,13 @@ config-db: enabled: true ``` -Or connect to an existing Clickhouse server using the `clickhouseURL` parameter. +Or connect to an existing ClickHouse server using the `clickhouseURL` parameter. ## Next Steps - - Full configuration options for Clickhouse scrapers + + Full configuration options for ClickHouse scrapers S3, CloudTrail, and other AWS data sources diff --git a/mission-control/docs/integrations/github.mdx b/mission-control/docs/integrations/github.mdx index feb39b90..bc9ad7ca 100644 --- a/mission-control/docs/integrations/github.mdx +++ b/mission-control/docs/integrations/github.mdx @@ -13,7 +13,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with GitHub to monitor repositories and trigger workflows. +GitHub is a cloud-based platform for version control and collaboration, hosting Git repositories with tools for code review, issue tracking, and CI/CD via GitHub Actions. Mission Control integrates with GitHub to query repository data, monitor workflow status, trigger Actions from playbooks, and catalog repository configurations. --- diff --git a/mission-control/docs/integrations/kubernetes/index.mdx b/mission-control/docs/integrations/kubernetes/index.mdx index 51f705cd..4d6e1bab 100644 --- a/mission-control/docs/integrations/kubernetes/index.mdx +++ b/mission-control/docs/integrations/kubernetes/index.mdx @@ -15,7 +15,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control provides deep integration with Kubernetes clusters for complete visibility into your containerized infrastructure. +Kubernetes is an open-source container orchestration platform that automates the deployment, scaling, and management of containerized applications across clusters of machines. Mission Control provides deep integration with Kubernetes for complete visibility into your cluster resources, change history, health status, and automated remediation. --- diff --git a/mission-control/docs/integrations/prometheus.mdx b/mission-control/docs/integrations/prometheus.mdx index e3c77a41..6bbb95b1 100644 --- a/mission-control/docs/integrations/prometheus.mdx +++ b/mission-control/docs/integrations/prometheus.mdx @@ -11,7 +11,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with Prometheus to monitor your metrics infrastructure. +Prometheus is an open-source monitoring and alerting toolkit that collects time-series metrics from your applications and infrastructure using a pull-based model. Mission Control integrates with Prometheus to run PromQL queries as health checks, and exposes its own Prometheus-compatible metrics endpoint so you can monitor Mission Control's health checks, scrapers, and notifications. --- diff --git a/mission-control/docs/integrations/slack.mdx b/mission-control/docs/integrations/slack.mdx index 8589deb5..1590066e 100644 --- a/mission-control/docs/integrations/slack.mdx +++ b/mission-control/docs/integrations/slack.mdx @@ -12,7 +12,7 @@ import { CapabilityBadges, CapabilityBadge, CapabilityHeading } from '@site/../c -Mission Control integrates with Slack to send notifications and scrape workspace data. +Slack is a business messaging platform that organizes team communication into channels and supports rich integrations with developer tools and services. Mission Control integrates with Slack to send alert notifications to channels and scrape workspace data into the catalog. ---