本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 开始使用
<a name="observability-get-started"></a>

启动您的可观测性堆栈， AWS 并在几分钟内开始发送遥测数据。

## 快速入门
<a name="observability-get-started-quick"></a>

部署 end-to-end可观测性堆栈的最快方法 AWS 是 CLI 安装程序。其创建了以下资源：
+ 亚马逊 OpenSearch 服务域名
+ 适用于 Prometheus 工作空间的亚马逊托管服务
+ Amazon OpenSearch Ingestion 渠道
+ 具有可观测性工作区的 OpenSearch UI 应用程序

或者，安装程序启动带有示例遥测的 OpenTelemetry Demo 的 EC2 实例。

运行以下命令开始安装：

```
bash -c "$(curl -fsSL https://raw.githubusercontent.com/opensearch-project/observability-stack/main/install.sh)" -- --deployment-target=aws
```

安装大约需要 15 分钟。

## CDK 部署
<a name="observability-get-started-cdk"></a>

对于 infrastructure-as-code，请使用 AWS CDK。CDK 部署创建了两个堆栈：


| 堆栈 | 它创造了什么 | 部署时间 | 
| --- | --- | --- | 
| ObsInfra | OpenSearch 域、适用于 Prometheus 的亚马逊托管服务工作空间、直接查询数据源、管道 IAM 角色 | 大约 17 分钟 | 
| ObservabilityStack | 精细访问控制映射、 OpenSearch 摄取管道、 OpenSearch UI 应用程序、仪表板初始化、演示工作负载（可选） | 大约 6 分钟 | 

运行以下命令进行部署：

```
cd aws/cdk
npm install
cdk deploy --all
```

有关更多信息，请参阅上的 [CDK 部署自述文件](https://github.com/opensearch-project/observability-stack/tree/main/aws/cdk)。 GitHub

## 发送遥测数据
<a name="observability-get-started-send"></a>

两种部署方法都会创建一个接受 OT OpenSearch LP 数据的摄取端点。将您的 OTel 收集器配置为使用 Sigv4 身份验证进行导出：

```
extensions:
  sigv4auth:
    region: us-west-2
    service: osis

exporters:
  otlphttp/logs:
    logs_endpoint: ${OSIS_ENDPOINT}/v1/logs
    auth: { authenticator: sigv4auth }
    compression: none
  otlphttp/traces:
    traces_endpoint: ${OSIS_ENDPOINT}/v1/traces
    auth: { authenticator: sigv4auth }
    compression: none
  otlphttp/metrics:
    metrics_endpoint: ${OSIS_ENDPOINT}/v1/metrics
    auth: { authenticator: sigv4auth }
    compression: none
```

**注意**  
在管道上发送数据的 IAM 委托人需要`osis:Ingest`和`aps:RemoteWrite`许可 ARN。

## 了解详情
<a name="observability-get-started-learn-more"></a>

使用以下资源了解有关发送遥测数据的更多信息：
+ [OpenTelemetry 仪器指南（每种语言）](https://observability.opensearch.org/docs/send-data/applications/)
+ [基础设施监控（AWS、Docker、Kubernetes、Prometheus）](https://observability.opensearch.org/docs/send-data/infrastructure/)
+ [OTel 收集器配置](https://observability.opensearch.org/docs/send-data/opentelemetry/collector/)
+ [数据管道和批处理](https://observability.opensearch.org/docs/send-data/data-pipeline/)
+ 本指南中的[Amazon OpenSearch Ingestion 概述](ingestion.md)