You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Restructure status informers docs to lead with SDK (#4093)
- Rename sections to make SDK the recommended approach
- Clarify that SDK works for both Helm CLI and Replicated installer
installations
- Relabel Application CR approach as KOTS existing cluster only
- Link to Application CR reference page
Part of KOTS de-emphasis Phase 2 (epic 137934, story sc-137946).
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/vendor/insights-app-status.md
+7-9Lines changed: 7 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,15 +22,13 @@ For more information about how instance data is sent to the Vendor Portal, see [
22
22
23
23
To display insights on application status, the Vendor Portal requires that your application has one or more _status informers_. Status informers indicate the Kubernetes resources deployed as part of your application that are monitored for changes in state.
24
24
25
-
For information about how to enable status informers, see the sections below:
The recommended approach is to include the Replicated SDK as a dependency of your Helm chart. The SDK automatically detects and reports application status for both Helm CLI and Replicated installer (Embedded Cluster, KOTS) installations.
28
26
29
-
### Helm CLI installations
27
+
### Configure status with the Replicated SDK (recommended) {#helm-cli-installations}
30
28
31
-
For Helm CLI installations, you can include the Replicated SDK as a dependency in your primary Helm chart to get status data. When the application is deployed using `helm install` or `helm upgrade`, the SDK automatically detects and reports the status of resources in the Helm release for the given chart. You can also override the list of resources that get reported on using the SDK's [`statusInformers`](https://github.com/replicatedhq/replicated-sdk/blob/main/chart/values.yaml#L287) value.
29
+
When you include the Replicated SDK as a dependency in your primary Helm chart, the SDK automatically detects and reports the status of resources in the Helm release. You can also override the list of resources that get reported on using the SDK's [`statusInformers`](https://github.com/replicatedhq/replicated-sdk/blob/main/chart/values.yaml#L287) value.
32
30
33
-
To get instance status data for installations with the Helm CLI:
31
+
To enable application status with the SDK:
34
32
35
33
1. In your application Helm chart `Chart.yaml` file, add the YAML below to declare the SDK as a dependency. If your application is installed as multiple charts, declare the SDK as a dependency of the chart that customers install first. Do not declare the SDK in more than one chart. For more information, see [Install the Replicated SDK](/vendor/replicated-sdk-installing).
36
34
@@ -57,12 +55,12 @@ To get instance status data for installations with the Helm CLI:
57
55
When `statusInformers` is set, the SDK reports the status of only the resources included in the `statusInformers` field.
58
56
:::
59
57
60
-
### Replicated installers
58
+
### Configure status with the Application custom resource (KOTS existing cluster only) {#replicated-installers}
61
59
62
-
To get instance insights from installations with a Replicated installer (Embedded Cluster, existing cluster KOTS, kURL), configure one or more status informers in the Replicated Application custom resource. For more information, see [Enable and understand application status](/vendor/insights-app-status).
60
+
For existing cluster installations with KOTS that do not include the Replicated SDK, you can configure status informers in the Replicated [Application custom resource](/reference/custom-resource-application). This is not required if you already include the SDK as a dependency of your Helm chart.
63
61
64
62
:::note
65
-
When Helm-based applications that include the Replicated SDK and are deployed by a Replicated installer, the SDK inherits the status informers configured in the Replicated Application custom resource. In this case, the SDK does _not_ automatically report the status of the resources that are part of the Helm release. This prevents discrepancies in the instance data in the vendor platform.
63
+
When Helm-based applications that include the Replicated SDK are deployed by a Replicated installer, the SDK inherits the status informers configured in the Application custom resource. In this case, the SDK does _not_ automatically report the status of the resources that are part of the Helm release. This prevents discrepancies in the instance data in the Vendor Portal.
66
64
:::
67
65
68
66
## View resource status insights {#resource-status}
0 commit comments