Download PDF
Download page Install Kubernetes and App Service Monitoring with Spectro Cloud Palette.
Install Kubernetes and App Service Monitoring with Spectro Cloud Palette
This page describes how to install Kubernetes and App Service Monitoring using the Spectro Cloud® Palette UI. Spectro Cloud Palette is an enterprise Kubernetes® management platform that enables organizations to manage the lifecycle of Kubernetes environments across data centers and clouds.
Splunk AppDynamics provides pre-published add-on packs that can be added to a Cluster Profile. Once the Cluster Profile is applied to any new or imported clusters, Kubernetes and App Service Monitoring is automatically installed on the cluster. Unlike the traditional installation process, this alternate installation process does not require manually accessing the Kubernetes cluster or using Helm chart commands.
This document contains references to third-party documentation. Splunk AppDynamics does not own any rights and assumes no responsibility for the accuracy or completeness of such third-party documentation.
Before You Begin
Ensure that you meet the following requirements:
- Your account is set up on Cisco Cloud Observability. See Account Administration.
- Your account is set up on Spectro Cloud Palette.
- You have the Cluster Profile Admin role on Spectro Cloud Palette. This role is required in order to create and modify Cluster Profiles.
- Depending on your use case, you also need one of the following roles:
- The Cluster Admin role is required to create new clusters.
- The Cluster Editor role can be used if you only want to edit clusters.
Hardware Requirements
The default hardware settings are:
Component | CPU | Memory | Supported Platforms | Per cluster or node |
---|---|---|---|---|
Cisco AppDynamics Distribution of OpenTelemetry Collector* | 200m | 1024MiB |
| Per node (Kubernetes DaemonSet) |
Splunk AppDynamics Operator | 200m | 128MiB |
| Per cluster (Kubernetes Deployment) |
Cisco AppDynamics Smart Agent | 350m | 512MiB |
| Per cluster (Kubernetes Deployment) |
Cluster Collector | 1000m | 1000MiB |
| Per cluster |
Cisco AppDynamics Infrastructure Collector | 350m |
|
| Per node (Kubernetes DaemonSet) |
Log Collector | 10m | 150MiB |
| Per node (Kubernetes DaemonSet) |
Windows Exporter | 200m | 200MiB |
| Per node (Kubernetes DaemonSet) |
OpenTelemetry Operator for Kubernetes** | 600m | 256MiB |
| Per cluster (Kubernetes Deployment) |
*For throughput-specific details, see Performance and Scaling for the Cisco AppDynamics Distribution of OpenTelemetry Collector.
**OpenTelemetry Operator manager and Kube RBAC Proxy
Software Requirements
Kubernetes and App Service Monitoring is designed to run in hybrid (Linux and Windows) or Linux-only clusters. Kubernetes and App Service Monitoring requires:
Sufficient licenses. See License Management.
- OpenTelemetry Agent versions that are supported by Cloud Native Application Observability.
Cluster Support
Linux Cluster | Windows and Linux Cluster |
---|---|
|
|
Splunk AppDynamics and OpenTelemetry Operators can only run on Linux nodes.
The k8s.cluster.id
attribute is required to send MELT data for Kubernetes entities. By default, Splunk AppDynamics add-on packs and Collectors attach the k8s.cluster.id
attribute to data from Splunk AppDynamics sources. To send data from third-party collectors, you must enrich your data with the k8s.cluster.id
attribute. The k8s.cluster.id
attribute must have a value equal to the UUID of the kube-system
namespace.
Install Kubernetes and App Service Monitoring Using Spectro Cloud Palette
These are the high-level steps:
- Obtain the Configuration Values
- Add the Cisco AppDynamics Add-On Packs to a Cluster Profile
You can either create a new cluster profile or add the add-on packs to an existing cluster profile. - Apply the Cluster Profile to a New or Imported Cluster
1. Obtain the Configuration Values
- Log into the Cisco Cloud Observability UI.
- Use the left-hand navigation panel to navigate to Configure > Kubernetes and APM.
- Under CONFIGURE DATA COLLECTORS, enter your credential set name and Kubernetes cluster name.
- Under ENABLE ADDITIONAL CONFIGURATIONS, check the boxes for Cluster Collector and Infrastructure Collector. Specify your operating system for each collector.
- (Optional) If you would like to enable Log Ingestion, check the box for Log Collector Agent and specify your operating system.
- Click Generate configuration file. This step generates the
operators-values.yaml
andcollectors-values.yaml
files. - In the
operators-values.yaml
file, obtain the values forclusterName
,endpoint
,clientId
,clientSecret
,tokenUrl
, andtenantId
.
You can leave this UI page open, or download the file. You'll need to provide these values later in the Spectro Cloud Palette UI. - In the
collectors-values.yaml
file, obtain the values forclusterName
,clientId
,clientSecret
,endpoint
, andtokenUrl
.
You can leave this UI page open, or download the file. You'll need to provide these values later in the Spectro Cloud Palette UI.
2. Add the Splunk AppDynamics Add-On Packs to a Cluster Profile
Refer to the respective page for the type of Cluster Profile that you want to create in Create a Cluster Profile.
When the instructions prompt you to add a pack:
- Add the Cisco AppDynamics Operator pack:
- Click Add New Pack.
- Set the Registry to Palette Community Registry. In the search bar, enter Cisco AppDynamics Operator.
- Under Monitoring, click Cisco AppDynamics Operator. The Configure Pack page is now displayed.
- Under Pack Version, use the drop-down menu to select the latest version of the pack.
- The values file is displayed on the right side of the page.
Add the value for
clusterName
.By default, every cluster created with this Cluster Profile will have the specified name. You can also modify the
clusterName
field when you create the cluster. If you are using a single Cluster Profile for multiple clusters, we recommend using a unique cluster name whenever you create a new cluster.- Under
appdynamics-smartagent
, add the values forendpoint
,clientId
,clientSecret
,tokenUrl
, andtenantId
that you obtained from theoperators-values.yaml
file. - Click Confirm & Create.
- Add the Cisco AppDynamics Collector pack:
- Click Add New Pack.
- Set the Registry to Palette Community Registry. In the search bar, enter Cisco AppDynamics Collector.
- Under Monitoring, click Cisco AppDynamics Collector. The Configure Pack page is now displayed.
- Under Pack Version, use the drop-down menu to select the latest version of the pack.
- The values file is displayed on the right side of the page.
- Add the value for
clusterName
. This should be the sameclusterName
that you entered in the Cisco AppDynamics Operator values file during step 1f. Under
appdynamics-otel-collector
, add the values forclientId
,clientSecret
,endpoint
, andtokenUrl
that you obtained from thecollectors-values.yaml
file.Ensure that the
oauth
parameter is added under the global section. The configuration will be similar to the following:global: clusterName: <cluster-name> oauth: clientId: <client-ID> clientSecret: <client-secret> endpoint: <endpoint-URL> tokenUrl: <token-URL>
CODE- Click Confirm & Create.
- Click Save Changes.
- Log into the Spectro Cloud Palette console.
- In the left-hand navigation panel, click Profiles. Select an existing Cluster Profile.
- Add the Cisco AppDynamics Operator pack:
- Click Add New Pack.
- Set the Registry to Palette Community Registry. In the search bar, enter Cisco AppDynamics Operator.
- Under Monitoring, click Cisco AppDynamics Operator. The Configure Pack page is now displayed.
- Under Pack Version, use the drop-down menu to select the latest version of the pack.
- The values file is displayed on the right side of the page.
Add the value for
clusterName
.By default, every cluster created with this Cluster Profile will have the specified name. You can also modify the
clusterName
field when you create the cluster. If you are using a single Cluster Profile for multiple clusters, we recommend using a unique cluster name whenever you create a new cluster.- Under
appdynamics-smartagent
, add the values forendpoint
,clientId
,clientSecret
,tokenUrl
, andtenantId
that you obtained from theoperators-values.yaml
file. - Click Confirm & Create.
- Add the Cisco AppDynamics Collector pack:
- Click Add New Pack.
- Set the Registry to Palette Community Registry. In the search bar, enter Cisco AppDynamics Collector.
- Under Monitoring, click Cisco AppDynamics Collector. The Configure Pack page is now displayed.
- Under Pack Version, use the drop-down menu to select the latest version of the pack.
- The values file is displayed on the right side of the page.
- Add the value for
clusterName
. This should be the sameclusterName
that you entered in the Cisco AppDynamics Operator values file during step 3f. Under
appdynamics-otel-collector
, add the values forclientId
,clientSecret
,endpoint
, andtokenUrl
that you obtained from thecollectors-values.yaml
file.Ensure that the
oauth
parameter is added under the global section. The configuration will be similar to the following:global: clusterName: <cluster-name> oauth: clientId: <client-ID> clientSecret: <client-secret> endpoint: <endpoint-URL> tokenUrl: <token-URL>
CODE- Click Confirm & Create.
- Click Save Changes.
3. Apply the Cluster Profile to a New or Imported Cluster
Once you have added the Splunk AppDynamics add-on packs to a Cluster Profile, you can apply the Cluster Profile to a new cluster or a cluster that was imported to Spectro Cloud. Kubernetes and App Service Monitoring is installed on every cluster that is deployed with this Cluster Profile.
You are required to add a Cluster Profile when you create a new cluster. Depending on the type of public cloud cluster you have, the process to create a new cluster and apply a Cluster Profile may vary. See Public Cloud Clusters for the specific documentation for your cluster.
By default, every cluster created with this Cluster Profile will have the clusterName
that you specified in the values files of the Splunk AppDynamics add-on packs. You can also modify the clusterName
field when you create the cluster. If you are using a single Cluster Profile for multiple clusters, we recommend using a unique cluster name whenever you create a new cluster.
Next Steps
After you install Kubernetes and App Service Monitoring, you can monitor your Kubernetes infrastructure or configure additional monitoring tools.
Monitor Your Kubernetes Infrastructure
- Log into the Cisco Cloud Observability UI.
- On the Observe page, navigate to the Kubernetes domain.
This domain contains links to entity-centric pages, which are UI pages that display everything of relevance (e.g., metrics, metadata, health status, events, logs, relationships) for a given entity. - Click an entity name to monitor your applications. For more information on the entities that can be monitored, see Kubernetes Entities.
Application Performance Monitoring
To monitor the applications running in your Kubernetes environment, follow the appropriate workflow from Set Up Application Performance Monitoring with Spectro Cloud Palette according to your service instrumentation status.
Log Collection
Log Collection is inactive by default. To collect logs, see Set Up Log Ingestion with Spectro Cloud Palette.
Events Collection
Kubernetes Kubernetes Events Collection is enabled by default. To disable events collection or make changes to existing events, see Configure Events Collection with Spectro Cloud Palette.
Advanced Installation and Configuration
For advanced settings, see:
- Cisco AppDynamics Collectors Settings
- Advanced Settings for the Cisco AppDynamics Distribution of OpenTelemetry Collector
- Cisco AppDynamics Operator Settings
- APM Auto-Instrumentation Settings
All settings specified in these docs must be configured in the values files of the Splunk AppDynamics Operator and Collector add-on packs.
Uninstall Kubernetes and App Service Monitoring
Uninstall Kubernetes and App Service Monitoring with Spectro Cloud Palette.
Spectro Cloud® is a registered trademark of Spectro Cloud, Inc. Mention of Spectro Cloud products or services is for informational purposes only and constitutes neither an endorsement nor a recommendation of such products or services.
Kubernetes® is a trademark of The Linux Foundation®.