Configuring Dynamic Telemetry Subscription (IPv4 Collector)

Dynamic telemetry subscription indicates that a collector functioning as a client initiates a connection to a device functioning as a server to collect data.

Usage Scenario

If a collector functioning as a client initiates a connection to a device functioning as a server, the data sampled is dynamically subscribed to. In this case, you need to configure the source IP address and number for a port to be listened, and enable the gRPC service. The protocol used to send data is gRPC.

If the connection where dynamic telemetry subscription resides is interrupted, the device automatically cancels the subscription and stops data sampling and reporting. The configuration cannot be restored unless the collector sends a connection request again. For example, if a user wants to monitor an interface for a period of time, configure dynamic telemetry subscription. To stop monitoring, tear down the connection. The subscription is automatically canceled and cannot be restored. This avoids the long-term load on devices and simplifies the interaction between users and devices.

Pre-configuration Tasks

Before configuring dynamic telemetry subscription, complete the following tasks:

  • Configure a static route or dynamic routing protocol to ensure that devices can communicate at the network layer.

  • Create a local user, add the user to the administrator group, and configure the service type of the user.
  • Create an ACL, if needed, for the gRPC service to control which clients can connect to the server. For details about how to create an ACL, see "ACL Configuration" in Configuration Guide > IP Services.

  • Create an SSL policy, if needed, for the gRPC service so that the server and client can establish a secure SSL connection. For details about how to create an SSL policy, see "Configuring and Binding an SSL Policy" in Configuration Guide > Basic Configuration.

Procedure

  1. Run system-view

    The system view is displayed.

  2. Run grpc

    The gRPC view is displayed.

  3. Run grpc server

    The gRPC server view is displayed.

  4. Run source-ip ip-address [ vpn-instance vpn-instance-name ]

    A source IP address to be listened during dynamic telemetry subscription is configured.

  5. (Optional) Run server-port port-number

    A port to be listened during dynamic telemetry subscription is set.

  6. (Optional) Run acl { acl-name | acl-number }

    An ACL is configured for the gRPC service during dynamic telemetry subscription.

  7. (Optional) Run idle-timeout time

    An idle timeout period is configured of the gRPC service during dynamic telemetry subscription.

  8. (Optional) Run ssl-policy ssl-policy-name

    An SSL policy is configured for the gRPC service during dynamic telemetry subscription.

  9. (Optional) Run ssl-verify peer

    A server is enabled to perform SSL verification on a client during dynamic telemetry subscription.

  10. (Optional) Run dscp value

    A DSCP value is set for data packets to be sent.

  11. Run server enable

    The gRPC service is enabled.

  12. (Optional) Configure a maximum usage for the main control board's CPU used when telemetry collects data.

    1. Run quit

      Return to the gRPC view.

    2. Run quit

      Return to the system view.

    3. Run telemetry

      The telemetry view is displayed.

    4. Run cpu-usage max-percent usage

      A maximum usage is configured for the main control board's CPU used when telemetry collects data.

    This command is supported only on the Admin-VS.

  13. Run commit

    The configuration is committed.

Verifying the Configuration

After the preceding configurations are performed and the collector delivers the data sampled, verify the configuration.

Run the display telemetry dynamic-subscription [ subName ] command to check the dynamic subscription information.

Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >