# SAP BTP 云日志记录技巧 ## 目录 * 服务概览 * 服务计划 * 快速启动 * 先决条件 * 实例创建选项 * 配置参数 * 完整配置示例 * 数据摄取方法 * 1\. Cloud Foundry 运行时 * 2\.凯玛运行时 * 3\.开放遥测 API (OTLP) * 4\. JSON接口 * 证书管理 * 证书有效期 * 捆绑资源 * 根 CA 轮换（3 步过程） * 开放搜索仪表板 * 访问 * 预建仪表板 * 自定义仪表板和警报 * 指数形态总结 * 安全最佳实践 * 安全建议 * SAML 身份验证设置 * 备份与恢复 * 自动备份 * 恢复过程 * 常见问题及故障排除 * 参考文件 * 文档链接 * 官方来源 * 相关文档 * 数据保护声明 ## 服务概述 SAP Cloud Logging 是基于 OpenSearch 构建的基于实例的可观察性服务，可存储、可视化和分析来自 SAP BTP Cloud Foundry、Kyma、Kubernetes 和其他运行时环境的应用程序日志、指标和跟踪。 **关键能力：** * 通过 OpenTelemetry (OTLP) 或 JSON API 摄取日志、指标和跟踪 * 从 Cloud Foundry 运行时获取应用程序和请求日志 * 配置数据保留（1-90 天） * 在 OpenSearch 仪表板中可视化和分析数据 * 创建自定义仪表板和警报 * 通过 SAP Identity Authentication Service 进行 SAML 身份验证 ** ** ## 服务计划计划|产能 |使用案例|自动缩放 ---|---|---|--- **开发** | 7.5 GB 固定 |仅评估|否 **标准** | 75 GB - 375 GB | 75 GB - 375 GB生产（100 条日志/秒）|是的 **大** | 750 GB - 3.75 TB | 750 GB - 3.75 TB生产（1000 条日志/秒）|是的 **重要提示：** 不支持计划更新。迁移需要并行运行实例。 ** ** ## 快速入门 ### 先决条件 1. SAP BTP 全球账户 2. 具有 Cloud Logging 权限的子账户 3.（推荐）用于 SAML 身份验证的 SAP Cloud Identity Services 租户 **SAP 构建代码用户注意事项：** 如果使用 SAP 构建代码，请按照 SAP 构建代码初始设置说明进行操作。 SAP 构建代码中的云日志记录仅可用于**评估目的**。 ### 实例创建选项根据您的工作流程选择一种方法： **选项 1：SAP BTP 主控室 (UI)** 1. 导航到子账户 → 实例和订阅 → 创建 2. 选择“云日志”服务并规划 3. 配置参数（参见配置部分） 4. 为凭证创建服务密钥 **选项 2：Cloud Foundry CLI** cf 创建服务云日志记录标准 my-cls-instance -c '{ “保留期”：14， “后端”：{“max_data_nodes”：10}， “摄取”：{“最大实例”：10 } }' # 等待配置 cf services # 检查“上次操作”状态 # 创建服务密钥 cf 创建服务密钥 my-cls-instance my-cls-key cf 服务密钥 my-cls-instance my-cls-key **选项 3：SAP BTP CLI** btp 创建服务/实例 \ --子帐户 \ --name my-cls-instance \ --offering-name“云日志记录”\ --计划名称标准\ --参数 '{"retention_period": 14}' # 创建绑定 btp 创建服务/绑定 \ --子帐户 \ --name my-cls-binding \ --实例名称 my-cls-实例 # 获取凭证 btp 获取服务/绑定 --name my-cls-binding --subaccount **选项 4：SAP BTP 服务运营商 (Kubernetes/Kyma)** api版本：services.cloud.sap.com/v1 种类：服务实例元数据：名称：云日志实例命名空间：sap-cloud-logging-integration 规格：服务产品名称：云日志记录服务计划名称：标准参数：保留期限：14 --- api版本：services.cloud.sap.com/v1 种类：服务绑定元数据：名称： cls 绑定命名空间：sap-cloud-logging-integration 规格：服务实例名称：云日志记录实例秘密名称：sap-cloud-logging ** ** ## 配置参数参数|类型 |默认 |描述 ---|---|---|--- `保留期` |整数 | 7 |数据保留天数 (1-90) `backend.max_data_nodes` |整数 | 10 | 10最大 OpenSearch 数据节点 (2-10) `dashboards.custom_label` |字符串| - |仪表板标识符（最多 20 个字符） `摄取.max_instances` |整数 | 10 | 10自动缩放的最大摄取实例数 (2-10) `摄取.min_instances` |整数 | 2 |最小摄取实例 (2-10) `ingest_otlp.enabled` |布尔 |假 |启用 OpenTelemetry 协议摄取 `feature_flags` |数组| []|实验性功能（例如“upgradeToOpenSearchV2”） `rotate_root_ca` |布尔 |假 |触发 CA 证书轮换 `萨姆尔` |对象| - | SAML 身份验证配置 ### 完整配置示例 { “保留期”：14， "feature_flags": ["upgradeToOpenSearchV2"], “仪表板”：{ "custom_label": "PROD-CLS" }, “后端”：{ “最大数据节点”：10 }, “摄取”：{ “最大实例数”：10， “最小实例”：2 }, “摄取_otlp”：{ “启用”：真 }, “萨姆”：{ “启用”：正确， “发起”：正确， "admin_group": "CLS-管理员", "roles_key": "组", “国内流离失所者”：{ "metadata_url": "[https://.accounts.ondemand.com/saml2/metadata",](https://.accounts.ondemand.com/saml2/metadata",) "entity_id": "[https://<租户>.accounts.ondemand.com"](https://<租户>.accounts.ondemand.com") }, “sp”：{ "entity_id": "cloud-logging-<实例 ID>" } } } ** ** ## 数据摄取方法 ### 1\. Cloud Foundry 运行时将应用程序直接绑定到 Cloud Logging 实例： cf 绑定服务 <应用程序名称> **索引模式：** * `logs-cfsyslog-*` \- 应用程序日志 * `metrics-otel-v1-*` \- 资源指标对于用户提供的带有 mTLS 的服务，请参阅“references/cf-ingestion.md”。 ### 2\.凯玛运行时需要启用“telemetry”和“btp-operator”模块： # 创建命名空间 kubectl 创建命名空间 sap-cloud-logging-integration # 部署ServiceInstance和ServiceBinding（参见上面的模板） kubectl apply -n sap-cloud-logging-integration -f cls-instance.yaml **索引模式：** * `logs-json-istio-envoy-kyma*` \- Istio 访问日志 * `logs-json-kyma*` \- 应用程序日志 ### 3\.开放遥测 API (OTLP) 使用 `ingest_otlp.enabled: true` 启用，然后配置您的应用程序： **服务密钥凭证：** * `ingest-otlp-endpoint` \- gRPC 端点（主机名：443） * `ingest-otlp-cert` \- 客户端证书 (PEM) * `ingest-otlp-key` \- 私钥 (PKCS#8) * `server-ca` \- 服务器 CA 证书 **索引模式：** * `logs-otel-v1-*` \- 日志 * `metrics-otel-v1-*` \- 指标 * `otel-v1-apm-span-*` \- 跟踪 * `otel-v1-apm-service-map` \- 服务地图 **注意：** 仅支持 gRPC 协议。使用 OpenTelemetry Collector 转换 http/protobuf 或 http/json。对于 Java/Node.js 自动化库，请参阅“references/opentelemetry-ingestion.md”。 ### 4\. JSON接口通过 HTTP 使用 mTLS 发送日志： curl -X PUT "[https:///v1/ingest"](https:///v1/ingest") \ --cert client.crt --key client.key \ -H“内容类型：application/json”\ -d '[{"msg": "日志消息", "date": "2025-01-15T10:30:00Z"}]' **索引模式：** `logs-json-*` 有关 Fluent Bit 配置，请参阅“references/json-api-ingestion.md”。 ** ** ## 证书管理 ### 证书有效期 * 默认：90 天 * 可配置：1-180天，通过绑定参数中的“certValidityDays” ### 根 CA 轮换（3 步过程） **注意：** 不遵循此流程会导致摄取中断。 1. **创建新的 CA:** 使用 `"rotate_root_ca": true` 更新实例 2. **重新绑定所有应用程序：** 为每个运输机制创建新的绑定 3. **删除旧 CA:** 使用 `"rotate_root_ca": false` 更新实例 ** ** ## OpenSearch 仪表板 ### 访问 1. 创建服务绑定/密钥 2. 从凭据导航到“dashboards-url” 3. 身份验证（SAML 或基本身份验证） ### 预建仪表板 * Cloud Foundry应用程序性能 * 请求延迟和错误率 * 资源利用率指标 ### 自定义仪表板和警报 * 创建自定义仪表板以满足特定分析需求 * 根据可观测性数据配置警报 * 与 **SAP Alert notification for SAP BTP** 集成，以实现高级警报工作流程 ### 指数模式总结来源 |指数形态 ---|--- CF 日志 | `日志-cfsyslog-*` CF 指标 | `指标-otel-v1-*` OTLP 日志 | `日志-otel-v1-*` OTLP 指标 | `指标-otel-v1-*` OTLP 痕迹 | `otel-v1-apm-span-*` JSON API | `日志-json-*` Kyma 应用程序 | `日志-json-kyma*` 凯玛·伊斯蒂奥 | `logs-json-istio-envoy-kyma*` **注意：** 由于 OpenSearch/Lucene 限制，属性名称使用“@”而不是“.”。 ** ** ## 安全最佳实践 ### 安全建议 * **BTP-CLS-0001：** 使用 Identity Authentication Service 配置 SAML 身份验证（关键） * **BTP-CLS-0002：** 定期轮换服务密钥；删除不会自动使凭据失效 * **BTP-CLS-0003:** 查看 Kyma 运行时和 JSON API 安全配置 **注意：** 当前仅向 SAP Cloud ALM 报告 BTP-CLS-0001（关键级别）。其他建议必须手动验证。 ### SAML 身份验证设置 1. 在 SAP Identity Authentication 中创建 SAML 2.0 应用程序 2. 从身份目录配置“组”属性 3. 将姓名 ID 格式设置为“电子邮件” 4.启用请求签名（推荐） 5、实例配置中配置`saml`参数 6. `admin_group` 映射到 `all_access` 角色有关详细设置，请参阅“references/saml-authentication.md”。 ** ** ## 备份与恢复 ### 自动备份 **备份：** OpenSearch 设置、角色、角色映射、租户、组、安全配置、保存的对象、ISM 策略 **未备份：** 警报 ### 恢复过程使用组件“BC-CP-CLS”创建 SAP 支持票证，包括： 1. 仪表板网址 2.实例配置 3. 取消配置时间戳 4. 目标恢复日期（最多 7 天） 5. 业主信息 6. 商业理由 ** ** ## 常见问题和故障排除 ### 实例创建失败 * 验证子账户的权限 * 检查该地区的服务计划可用性 * 验证 JSON 配置语法 ### 摄取不起作用 * 验证绑定凭据是否最新（检查证书是否过期） * 对于CF：绑定生效，无需重新暂存 * 对于 OTLP：确保 `ingest_otlp.enabled: true` * 检查摄取端点的网络连接 ### 仪表板访问问题 * 验证 SAML 配置（如果启用） * 检查用户是否在配置的管理员组中 * 验证 IdP 元数据 URL 可访问性 ### 证书过期 * 默认有效期：90 天 * 在过期之前创建新的绑定 * 如果根 CA 轮换广泛存在，请考虑轮换 ** ** ## 参考文件有关详细信息，请参阅捆绑的参考文件： ### 配置和设置 * `references/service-plans.md`（183 行）- 服务计划比较和容量规划 * `references/configuration-parameters.md` (270 行) - 带有示例的完整参数参考 ### 摄取方法 * `references/cf-ingestion.md`（211 行）- Cloud Foundry 摄取详细信息 * `references/kyma-ingestion.md`（293 行）- Kyma 运行时集成 * `references/opentelemetry-ingestion.md`（363 行）- 使用 Java/Node.js 自动化进行 OTLP 设置 * `references/json-api-ingestion.md`（435 行）- JSON API 和 Fluent Bit 配置 ### 安全与身份验证 * `references/saml-authentication.md`（329 行）- 使用身份验证服务进行 SAML 设置 ** ** ## 文档链接 ### 官方来源 * **GitHub 文档：** * **SAP 帮助门户：** * **发现中心：** * **容量估算器：** 在 Discovery Center 中引用 ## 捆绑资源 ### 参考文档 * `references/cf-ingestion.md` \- Cloud Foundry 运行时摄取指南 * `references/kyma-ingestion.md` \- Kyma/Cloud Foundry Kyma 运行时摄取 * `references/opentelemetry-ingestion.md` \- OpenTelemetry 数据摄取 * `references/json-api-ingestion.md` \- JSON API 摄取方法 * `references/saml-authentication.md` \- SAML 身份验证配置 * `references/service-plans.md` \- 服务计划比较和选择 ### 相关文档 * **OpenSearch：** * **SAP 云身份服务：** * **BTP 安全建议：** ** ** ## 数据保护声明 SAP Cloud Logging **不是为**个人或关键业务数据而设计的。采取措施防止此类数据的传输。数据按区域存储，但物理数据中心位置可能与同一区域内的消费位置不同。

SAP Btp 云日志记录

包含技能