1. Select API key をクリックして、使用する Datadog API キーを選択します。
2. UI で提供されるコマンドを実行して Worker をインストールします。コマンドには、先ほど入力した環境変数が自動的に入力されます。

   docker run -i -e DD_API_KEY=<DATADOG_API_KEY> \
       -e DD_OP_PIPELINE_ID=<PIPELINE_ID> \
       -e DD_SITE=<DATADOG_SITE> \
       -e <SOURCE_ENV_VARIABLE> \
       -e <DESTINATION_ENV_VARIABLE> \
       -p 8088:8088 \
       datadog/observability-pipelines-worker run
   

   注: デフォルトでは、docker run コマンドは Worker がリッスンしているのと同じポートを公開します。ワーカーのコンテナポートを Docker ホストの別のポートにマッピングしたい場合は、コマンドで -p | --publish オプションを使用します。

   -p 8282:8088 datadog/observability-pipelines-worker run
   

3. Observability Pipelines のインストールページに戻り、Deploy をクリックします。

パイプラインの構成を変更したい場合は、既存のパイプラインの更新を参照してください。

1. Download the Helm chart values file. If you are not using a managed service such as Amazon EKS, Google GKE, or Azure AKS, see Self-hosted and self-managed Kubernetes clusters before continuing to the next step.
2. Click Select API key to choose the Datadog API key you want to use.
3. Add the Datadog chart repository to Helm:

   helm repo add datadog https://helm.datadoghq.com
   

   If you already have the Datadog chart repository, run the following command to make sure it is up to date:

   helm repo update
   

4. Run the command provided in the UI to install the Worker. The command is automatically populated with the environment variables you entered earlier.

   helm upgrade --install opw \
   -f values.yaml \
   --set datadog.apiKey=<DATADOG_API_KEY> \
   --set datadog.pipelineId=<PIPELINE_ID> \
   --set <SOURCE_ENV_VARIABLES> \
   --set <DESTINATION_ENV_VARIABLES> \
   --set service.ports[0].protocol=TCP,service.ports[0].port=<SERVICE_PORT>,service.ports[0].targetPort=<TARGET_PORT> \
   datadog/observability-pipelines-worker
   

   Note: By default, the Kubernetes Service maps incoming port <SERVICE_PORT> to the port the Worker is listening on (<TARGET_PORT>). If you want to map the Worker’s pod port to a different incoming port of the Kubernetes Service, use the following service.ports[0].port and service.ports[0].targetPort values in the command:

   --set service.ports[0].protocol=TCP,service.ports[0].port=8088,service.ports[0].targetPort=8282
   

5. Navigate back to the Observability Pipelines installation page and click Deploy.

See Update Existing Pipelines if you want to make changes to your pipeline’s configuration.

Self-hosted and self-managed Kubernetes clusters

If you are running a self-hosted and self-managed Kubernetes cluster, and defined zones with node labels using topology.kubernetes.io/zone, then you can use the Helm chart values file as is. However, if you are not using the label topology.kubernetes.io/zone, you need to update the topologyKey in the values.yaml file to match the key you are using. Or if you run your Kubernetes install without zones, remove the entire topology.kubernetes.io/zone section.

Follow the steps below if you want to use the one-line installation script to install the Worker. Otherwise, see Manually install the Worker on Linux.

1. Click Select API key to choose the Datadog API key you want to use.

2. Run the one-step command provided in the UI to install the Worker.

   Note: The environment variables used by the Worker in /etc/default/observability-pipelines-worker are not updated on subsequent runs of the install script. If changes are needed, update the file manually and restart the Worker.

3. Navigate back to the Observability Pipelines installation page and click Deploy.

See Update Existing Pipelines if you want to make changes to your pipeline’s configuration.

1. ドロップダウンのオプションを 1 つ選択し、パイプラインで予想されるログの量を入力します。

   オプション	説明
   Unsure	ログの量を予想できない場合、または Worker をテストしたい場合は、このオプションを使用します。このオプションは、最大 2 つの汎用 t4g.large インスタンスで EC2 オートスケーリンググループをプロビジョニングします。
   1-5 TB/day	このオプションは、最大 2 つのコンピュート最適化インスタンス c6g.large で EC2 オートスケーリンググループをプロビジョニングします。
   5-10 TB/day	このオプションは、最低 2 つ、最大 5 つのコンピュート最適化インスタンス c6g.large で EC2 オートスケーリンググループをプロビジョニングします。
   >10 TB/day	Datadog は大規模な本番デプロイでこのオプションを推奨しています。このオプションは、最低 2 つ、最大 10 個のコンピュート最適化インスタンス c6g.xlarge で EC2 オートスケーリンググループをプロビジョニングします。

   注: その他のパラメーターは、すべて Worker デプロイメントに適したデフォルト値に設定されていますが、スタックを作成する前に AWS コンソールで必要に応じてユースケースに合わせて調整できます。

2. Worker のインストールに使用する AWS リージョンを選択します。

3. Select API key をクリックして、使用する Datadog API キーを選択します。

4. Launch CloudFormation Template をクリックして AWS コンソールに移動し、スタックの構成を確認してから起動します。CloudFormation パラメーターが想定通りであることを確認してください。

5. Worker のインストールに使用する VPC とサブネットを選択します。

6. IAM の必要な権限のチェックボックスを見直して確認します。Submit をクリックしてスタックを作成します。ここでは、CloudFormation がインストールを処理し、Worker インスタンスが起動され、必要なソフトウェアがダウンロードされ、Worker が自動的に開始します。

7. Observability Pipelines のインストールページに戻り、Deploy をクリックします。

パイプラインの構成を変更したい場合は、既存のパイプラインの更新を参照してください。

1. Set up APT transport for downloading using HTTPS:

   sudo apt-get update
   sudo apt-get install apt-transport-https curl gnupg
   

2. Run the following commands to set up the Datadog deb repo on your system and create a Datadog archive keyring:

   sudo sh -c "echo 'deb [signed-by=/usr/share/keyrings/datadog-archive-keyring.gpg] https://apt.datadoghq.com/ stable observability-pipelines-worker-2' > /etc/apt/sources.list.d/datadog-observability-pipelines-worker.list"
   sudo touch /usr/share/keyrings/datadog-archive-keyring.gpg
   sudo chmod a+r /usr/share/keyrings/datadog-archive-keyring.gpg
   curl https://keys.datadoghq.com/DATADOG_APT_KEY_CURRENT.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
   curl https://keys.datadoghq.com/DATADOG_APT_KEY_06462314.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
   curl https://keys.datadoghq.com/DATADOG_APT_KEY_F14F620E.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
   curl https://keys.datadoghq.com/DATADOG_APT_KEY_C0962C7D.public | sudo gpg --no-default-keyring --keyring /usr/share/keyrings/datadog-archive-keyring.gpg --import --batch
   

3. Run the following commands to update your local apt repo and install the Worker:

   sudo apt-get update
   sudo apt-get install observability-pipelines-worker datadog-signing-keys
   

4. Add your keys, site (for example, datadoghq.com for US1), source, and destination environment variables to the Worker’s environment file:

   sudo cat <<EOF > /etc/default/observability-pipelines-worker
   DD_API_KEY=<DATADOG_API_KEY>
   DD_OP_PIPELINE_ID=<PIPELINE_ID>
   DD_SITE=<DATADOG_SITE>
   <SOURCE_ENV_VARIABLES>
   <DESTINATION_ENV_VARIABLES>
   EOF
   

5. Start the worker:

   sudo systemctl restart observability-pipelines-worker
   

Note: The environment variables used by the Worker in /etc/default/observability-pipelines-worker are not updated on subsequent runs of the install script. If changes are needed, update the file manually and restart the Worker.

See Update Existing Pipelines if you want to make changes to your pipeline’s configuration.

1. Set up the Datadog rpm repo on your system with the below command.
   Note: If you are running RHEL 8.1 or CentOS 8.1, use repo_gpgcheck=0 instead of repo_gpgcheck=1 in the configuration below.

   cat <<EOF > /etc/yum.repos.d/datadog-observability-pipelines-worker.repo
   [observability-pipelines-worker]
   name = Observability Pipelines Worker
   baseurl = https://yum.datadoghq.com/stable/observability-pipelines-worker-2/\$basearch/
   enabled=1
   gpgcheck=1
   repo_gpgcheck=1
   gpgkey=https://keys.datadoghq.com/DATADOG_RPM_KEY_CURRENT.public
       https://keys.datadoghq.com/DATADOG_RPM_KEY_B01082D3.public
   EOF
   

2. Update your packages and install the Worker:

   sudo yum makecache
   sudo yum install observability-pipelines-worker
   

3. Add your keys, site (for example, datadoghq.com for US1), source, and destination environment variables to the Worker’s environment file:

   sudo cat <<-EOF > /etc/default/observability-pipelines-worker
   DD_API_KEY=<API_KEY>
   DD_OP_PIPELINE_ID=<PIPELINE_ID>
   DD_SITE=<SITE>
   <SOURCE_ENV_VARIABLES>
   <DESTINATION_ENV_VARIABLES>
   EOF
   

4. Start the worker:

   sudo systemctl restart observability-pipelines-worker
   

5. Navigate back to the Observability Pipelines installation page and click Deploy.

Note: The environment variables used by the Worker in /etc/default/observability-pipelines-worker are not updated on subsequent runs of the install script. If changes are needed, update the file manually and restart the Worker.

See Update Existing Pipelines if you want to make changes to your pipeline’s configuration.