arrow-left

All pages
gitbookPowered by GitBook
1 of 5

Loading...

Loading...

Loading...

Loading...

Loading...

Install Log Agent

If you install the log agent, you can check the collected container logs and audit logs on the cocktail dashboard.

hashtag
1. Distribution Addon

1) Infrastructure - Cluster - Addon List - Click the "Deploy" button and click the "Deploy" button for 'cocktail-log-agent' in the list.

2) Check the settings according to your environment and click the Deploy button to deploy the Addon.

Enable Container log collecting : Whether to collect container logs

Enable Audit log collecting : Whether to collect cluster audit logs

audit-log hostPath path : If it is not a cluster installed with 'cube', you will need to change the path.

includeNamespace : List of collection processing namespaces

If you are collecting container logs for a specific namespace, uncomment and use below.

Install Log Service

Log Service uses 'OpenSearch' to provide log storage and an API server to communicate with Cocktail Dashboard.

circle-info

Before installing the log service, 'cert-manager' and 'nginx' require pre-installation.

Install Log Operator

Log Operator is an Addon required when using automatic container log measurement among application log collection methods.

hashtag
1. Distribution Addon

1) Infrastructure - Clusters - Addon List - Click the "Deploy" button and click the "Deploy" button for 'cocktail-log-operator' in the list.

2) Check the settings according to your environment and click the Deploy button to deploy the Addon.

hashtag
1. Distribution Addon

1) Infrastructure - Clusters - Addon List - Click the "Deploy" button and click the "Deploy" button for 'cocktail-log-service' in the list.

2) Check the settings according to your environment and click the Deploy button to deploy the Addon.

Gateway Service Mode : Log service gateway type (Ingress, LoadBalancer)


[If Gateway Service Mode is set to Ingress]

Gateway Access URL : DNS to access log service through Ingress

URL Type : Cluster HostAliases type (PublicDNS or HostAliases)

Host Ip : (If URL Type is 'HostAliases') LB IP (or node IP) that can access the cluster from outside

circle-check

When accessing the log service from the dashboard or collecting logs from log-agent, connect the Host IP to the Log Access URL.

Enable OpenSearch Dashboard : Use or not 'Opensearch Dashboard'


[If Gateway Service Mode is set to LoadBalancer]

circle-info

Clusters created through provisioning can only be set to 'Enable OpenSearch Dashboard'.

3) Check the deployment status and if the status is 'Running', confirm that the deployment has been completed successfully.

If the status is 'pending' when deployed

4) Create a job in the namespace where the log service is installed.

Create a Job that creates policies for each container log, cluster audit log, and application log collected by Opensearch.

registry address : Please contact our technical team.

If you create a job according to the settings above, container logs have a storage period of 30 days, cluster audit logs have a storage period of 56 days, and application logs have a storage period of 1 year.

circle-info

Storage period settings can be modified in 'OpenSearch Dashboard'.

3) Check the deployment status and if it is Running, confirm that the deployment has been completed successfully.

Registration Log Service

Only one log service installed on the platform can be registered.

hashtag
1. Load the list of log services installed as Addon and register them on the platform

1) Settings - Basic Information, click the selection box for the log service name to view the list of installed log services.

2) Specify the log service you want to register and click the “Register” button to register it on the platform.

hashtag
Change log service

When changing the log service, simply select a different log service from the list and click the "Register" button to change it.

hashtag
Deregister log service

You can discontinue the log service function registered on the platform by clicking the “Deregister” button.

apiVersion: batch/v1
kind: Job
metadata:
  name: policy-generate
  namespace: cocktail-logs
spec:
  ttlSecondsAfterFinished: 600
  template:
    spec:
      containers:
        - image: [registry address]/library/cocktail-auto-injector:1.0.0-release.20240425
          imagePullPolicy: Always
          command:
            - /bin/sh
            - -c
            - sh /auto/service/gen.sh -H opensearch-cluster-master.cocktail-logs -c 30d -u 100d -a 30d -m run
          name: gen
      restartPolicy: Never
  backoffLimit: 0
Troubleshooting | Cocktail Cloud Onlinecocktailcloud.gitbook.iochevron-right
Logo

Installation

You can collect and analyze each log by installing and registering a log service in your cluster.