Enable O11y Addons

    Before installing observability addons, we recommend you to start from the introduction of the observability feature.

    To enable the observability addons, you simply need to run the commands as below.

    1. Install the kube-state-metrics addon
    1. Install the node-exporter addon
      1. Install the prometheus-server addon
      1. vela addon enable prometheus-server
      1. Install the loki addon
      1. Install the grafana addon
        1. Access your grafana through port-forward.
        1. kubectl port-forward svc/grafana -n o11y-system 8080:3000

        Now you can access your grafana by access http://localhost:8080 in your browser. The default username and password are and kubevela respectively.

        You will see several pre-installed dashboards and use them to view your system and applications. For more details of those pre-installed dashboards, see Out-of-the-Box section.

        caution

        Resource: The observability suite includes several addons which requires some computation resources to work properly. The recommended installation resources for you cluster are 2 cores + 4 Gi memory.

        Version: We recommend you to use KubeVela (>= v1.6.0) to use the observability addons. For version v1.5.0, logging is not supported.

        Enable O11y Addons - 图4tip

        Addon Suite: If you want to enable these addons in one command, you can use to orchestrate the install process. It allows you to manage the addon enable process as code and make it reusable across different systems.

        Multi-cluster Installation

        By default, the installation process for kube-state-metrics, node-exporter and prometheus-server are natually multi-cluster supported (they will be automatically installed to all clusters). But to let your on the control plane to be able to access prometheus-server in managed clusters, you need to use the following command to enable prometheus-server.

        This will install sidecar & query along with prometheus-server. Then enable grafana, you will be able to see aggregated prometheus metrics now.

        You can also choose which clusters to install addons by using commands as below

        1. vela addon enable kube-state-metrics clusters=\{local,c2\}

        For loki addon, the storage is hosted on the hub control plane by default, and the agent (promtail or ) installation is multi-cluster supported. You can run the following command to let multi-cluster agents to send logs to the loki service on the local cluster.

        1. vela addon enable loki agent=vector serviceType=LoadBalancer

        If you add new clusters to your control plane after addons being installed, you need to re-enable the addon to let it take effect.