Deploy container Monitoring Points

Deploy a Monitoring Point to a Docker, Podman, or Kubernetes (Helm) environment inside your cloud, hybrid, or multi-cloud network to monitor your network or web application performance.

To start monitoring, download the container Monitoring Point installation bundle from Google Cloud, and then follow the instructions from AppNeta to install it on the target host.

Before you begin

The deployment environment and Monitoring Points have specific networking requirements to ensure that the Monitoring Point can be installed successfully and communicate back to the Cloud Network Insights control plane.

Required roles

To get the permissions that you need to add Monitoring Points, ask your administrator to grant you the Cloud Network Insights Editor (roles/networkmanagement.CloudNetworkInsightsEditor) IAM role on the project that has Cloud Network Insights enabled. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Firewall requirements

Since we recommend installing Monitoring Points behind your firewalls, you might need to modify your firewall rules. Monitoring Points require outbound internet access to communicate back to the Cloud Network Insights control plane.


Protocol
Port
Description

TCP
443 (HTTPS)
Required. Connectivity to the Cloud Network Insights control plane

UDP
123 (NTP)
Required. Network Time Protocol. The Monitoring Point will fail to connect if time is not synced

UDP/TCP
53 (DNS)
Required. Domain Name Service to resolve Cloud Network Insights endpoints

UDP
3239, 33434
Test Traffic. Required for standard Network Path monitoring (dual-ended)

ICMP
Type 8 (echo request)
Test Traffic. Required for single-ended paths (for example, pinging 8.8.8.8).

For more information, see Firewall Configuration from AppNeta.

Monitoring Point requirements

Review the AppNeta Monitoring Point specifications to ensure that you can successfully deploy them.

Download Monitoring Point installation bundle

Get the installation bundle and ensure that the bundle is on the target host.

Console

If you have administrator credentials to the target host or if you need to download the installation bundle locally before transferring the file to the target host, use the Google Cloud console.

  1. In the Google Cloud console, navigate to Network Intelligence > Cloud Network Insights > Monitoring Points.

    Go to Cloud Network Insights

  2. Click Add monitoring point.

  3. In the Platform Type list, select Docker/Podman or Helm (Kubernetes), and then click Continue.

  4. Enter the Hostname of the container. This is the name of the host you're installing the Monitoring Point on.

  5. In Download the Monitoring Point, choose how you want to download the installation bundle.

    • To download the installation bundle on the target host using a terminal, select Run a command on the host.
      1. Click Open shell and generate token. You might need to authorize Cloud Shell.
      2. Press Enter to generate a token, and then copy and paste it in the text field.
      3. Open a terminal to your target host using administrator credentials, and run the generated command to download the installation bundle. The curl command is valid for one hour.
    • To download the installation bundle locally, select Download locally.
      1. Click Download Monitoring Point.
      2. Move the installation bundle to the target host.

gcloud

Use this method if your target host has Google Cloud CLI installed.

gcloud network-management network-monitoring-providers \
monitoring-points download-install-script \
--network-monitoring-provider=PROVIDER_NAME --location=global \
--monitoring-point-type=MP_TYPE \
--hostname=HOST_NAME \
--output-file=compose.HOST_NAME.tar.gz

Replace the following:

  • PROVIDER_NAME: the provider name, external by default.
  • MP_TYPE: the Monitoring Point container type. Use one of the following values:
    • Enter CONTAINER for Docker or Podman
    • Enter HELM for Helm (Kubernetes)
  • HOST_NAME: the name of the host you're installing the Monitoring Point on.

Install your container-based Monitoring Point

Once the install bundle is on the target host, follow the instruction from AppNeta to install the Monitoring Point.

You can't change the configuration settings for containers. If you need to change the proxy, NTP, or timezone settings later, you delete the Monitoring Point and add a new one.

Verify the install

Open the Google Cloud console and navigate to Network Intelligence Center > Cloud Network Insights. After 2–5 minutes, the Monitoring Point appears in the table with the status Active. If it doesn't appear within ten minutes, see Troubleshooting.

Remove Monitoring Points

To remove a Monitoring Point, delete it in AppNeta. For more information about removing a Monitoring Point, see the AppNeta documentation.

What's next

After you add Monitoring Points, it's time to create monitoring policies to populate Cloud Network Insights with data.