Control plane

_source/logzio_collections/_log-sources/control-plane.md

@@ -0,0 +1,90 @@
+---
+title: Ship logs from Control Plane
+logo:
+  logofile: control-plane.png
+  orientation: vertical
+data-source: Control Plane
+description: Ship logs from Control Plane
+data-for-product-source: Logs
+templates: ["network-device-filebeat"]
+contributors:
+  - nshishkin
+shipping-tags:
+  - popular
+order: 1380
+---
+
+Control Plane is a hybrid platform that integrates multiple cloud services, such as AWS, GCP, and Azure, providing a unified and flexible environment for developers to build and manage backend applications and services across various public and private clouds.
+
+Deploy this integration to ship all `Org` logs from your Control Plane account to Logz.io.
+
+**Before you begin, you'll need**:
+
+* Control Plane account
+
+<div class="tasklist">
+
+
+##### Store the Logz.io secret as an Opaque Secret
+
+1. Log in to [Control Plane Console UI](https://console.cpln.io/).
+2. Navigate to **Secrets**.
+3. Create a new secret.
+4. Give the secret a name.
+5. Select `Opaque` from the **Secret Type list**.
+6. Paste `<<LOG-SHIPPING-TOKEN>>` into the content text box.
+7. Click **Create**.
+
+{@include: ../../_include/log-shipping/log-shipping-token.html}
+
+##### Enable Control Plane logging
+
+###### Using the UI Console
+
+1. Open the [Control Plane Console UI](https://console.cpln.io/).
+2. Click on **Org** in the left menu.
+3. Click **External Logs** in the middle context menu.
+4. Select `Logz.io` and fill out the required fields.
+5. Select the Opaque secret created to authenticate to Logz.io.
+6. Click **Save**.
+
+###### Using the CLI
+
+1. Prepare the YAML manifest:
+
+```yaml
+kind: org
+name: ORG_NAME
+spec:
+  logging:
+    logzio:
+      credentials: //secret/<<LOG-SHIPPING-TOKEN>>
+      listenerHost: <<LISTENER-HOST>>
+```
+
+Replace `ORG_NAME` with your organization's name.
+
+{@include: ../../_include/log-shipping/log-shipping-token.html}
+
+{@include: ../../_include/log-shipping/listener-var.html}
+
+2. Save the file, for example, `logging-config.yaml`.
+
+3. Open your command line interface (CLI) and navigate to the directory where the `logging-config.yaml` file is saved.
+
+4. Execute the following command, replacing `ORG_NAME` with your organization's name:
+
+```shell
+cpln org patch ORG_NAME -f logging-config.yaml
+```
+
+
+##### Check Logz.io for your logs
+
+Spin up your Docker containers if you haven't done so already. Give your logs some time to get from your system to ours, and then open [Open Search Dashboards](https://app.logz.io/#/dashboard/osd).
+
+If you still don't see your logs, see [log shipping troubleshooting]({{site.baseurl}}/user-guide/log-shipping/log-shipping-troubleshooting.html).
+
+</div>
+
+