管理Project

更新时间: 2025-06-27 14:53:49

项目(Project)是日志服务中的资源管理单元,是进行资源隔离与访问控制的主要边界。同时它也是您访问日志服务资源的入口。

基本概念

项目(Project)是日志服务的资源管理单元,用于资源隔离和控制。

Project中可包含Logstore、MetricStore和机器组等资源,同时它也是您访问日志服务资源的入口。建议使用不同的Project管理不同的应用、产品或项目中的数据。具体说明如下:

  • 组织、管理不同的Logstore或MetricStore:在实际使用中,您可能需要使用日志服务采集及存储不同项目、产品或者环境的日志。您可以把不同项目、产品或者环境中的日志分类管理在不同Project中,便于后续的日志消费、导出或者分析。

  • 用于访问控制隔离:您可以为RAM用户授予指定Project的操作权限。

  • 提供日志服务资源的访问入口:日志服务为每个Project配置一个独立的访问入口。该访问入口支持通过网络写入、读取及管理日志。关于访问入口的更多信息,请参见服务接入点

权限须知(可展开)

  • 若您使用阿里云主账号登录,默认拥有所有操作权限,可直接对Project进行相关操作。

  • 若您使用RAM账号登录,请根据需要向主账号使用者申请如下两种日志服务的系统策略。

    • AliyunLogFullAccess:管理日志服务的权限。

    • AliyunLogReadOnlyAccess:只读访问日志服务的权限。

    当系统策略无法满足您的需求,您可以参考下表通过创建自定义权限策略实现精细化权限管理。

    操作

    所需权限

    创建Project

    • log:ListProject

    • log:CreateProject

    删除Project

    • log:ListProject

    • log:GetProject

    • log:DeleteProject

    回收站Project操作

    • log:ListProjectsInRecycleBin

    • log:CreateProject

    • log:DeleteProject

    • log:UpdateProject

    查看指定Project

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    管理资源配额

    同查看指定Project。

    设置传输加速

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:PutProjectTransferAcceleration

    设置资源组

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:ChangeResourceGroup

    设置标签

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:TagResources

    • log:UntagResources

    设置自定义域名

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:CreateDomain

    Project资源监控

    • log:ListProject

    • log:GetProject

    • log:ListLogStores

    • log:ListSavedSearch

    • log:ListDashboard

    • log:ListDomains

    • log:GetSqlInstance

    • log:ListTagResources

    • log:GetLogging

    • log:CreateLogStore

    • log:CreateIndex

    • log:UpdateIndex

    • log:CreateDashboard

    • log:UpdateDashboard

    • log:GetLogStore

    • log:UpdateLogStore

    • log:UpdateLogging

    • log:GetLogStoreLogs

创建Project

您可以通过创建项目来管理某一个应用的所有日志及相关的日志源。

控制台

  1. 登录日志服务控制台,在Project列表区域,单击创建Project

  2. 配置Project:

    1. 所属地域:请根据日志来源等信息选择合适的阿里云地域。创建Project后,您无法修改其所属地域,且日志服务不支持跨地域迁移Project。如果您要采集ECS日志,建议选择与ECS相同的地域,实现通过阿里云内网采集日志,加快日志采集速度。

    2. Project名称:Project名称在阿里云内全局唯一,创建后不可修改。

    3. 其余配置无需修改,使用默认值即可。

API

CreateProject - 创建Project

开启Project删除防护

重要数据对应的Project建议开启回收站功能,避免误删。开启后Project被删除将进入回收站,回收站中的Project进入静默状态,不支持读写,如静默后发现存在业务关联可快速恢复。回收站仅收取数据存储费用。

说明

Project进入回收站后,默认保存7天,到期后自动执行删除操作。

控制台

开启回收站功能

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 在Project页面的项目概览-基础信息-Project回收站中查看状态,若为未开启,单击开启

API

修改UpdateProject - 更新Project接口中的recycleBinEnabled。

Project资源删除与恢复

删除Project可能导致日志库的数据丢失,请确认Logstore,MetricStore、EventStore等数据无用或已做好数据备份。

说明

删除Project的当天仍会产生存储等费用,次日停止计费。即您在删除Project的第三天不会再收到日志服务的账单。

控制台

  1. 删除前清理

    • 无关联资源:

      • 在弹性计算、存储服务、安全、数据库等多种阿里云云产品开通日志分析服务,会在日志服务控制台自动创建对应的Project和Logstore。如果不需要云产品日志,需要在对应云产品控制台关闭日志分析服务。确保Project与其他阿里云服务无关联。

    • 无计费依赖:Project若为付费类型(如存储包、预留实例),需先退订或释放资源。

  2. 删除步骤

    1. 备份重要数据(可选)

      • Logstore数据备份:若Project中包含需保留的日志数据,需通过SLS的下载日志功能提前导出。

      • 配置信息备份:记录Project名称、存储容量、访问控制等关键配置,避免删除后信息丢失。

    • 执行Project删除

      • 在Project列表中,单击目标Project对应的删除

      • 删除Project面板中,输入Project名称并选择删除原因,然后单击确定

        警告

        删除Project后,其管理的所有日志数据及配置信息都会被释放,不可恢复。在删除Project前请慎重确认,避免数据丢失。

      • 确认操作:阅读提示后,输入Project名称进行二次确认。

  3. 若目标Project已开启Project回收站功能,您可在Project列表的回收站Project中查看,Project进入回收站后,默认保存7天,在此期间您可以选择恢复或者彻底删除。

API

DeleteProject - 删除指定Project

管理资源配额

当您的资源配额不足时,您可以根据实际需求调整Project的多个指标,包括logstore上限,shard上限,logtail采集配置上限,机器组上限等。

控制台

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 在Project页面的项目概览-基础信息-资源配额中单击管理,即可在资源配额面板中,调整目标资源的配额,然后单击保存提交申请。修改申请需要等待1小时左右完成。

支持的配置项

Quota指标

指标说明

默认值

可调整上限

logstore上限

1个Project中最多可创建的Logstore数量。

200

400

shard上限

一个Project中最多可创建Shard数量。

400

800

logtail采集配置上限

1个Project中最多可创建Logtail配置数量。

200

400

机器组上限

1个Project中最多可创建机器组数量。

200

400

仪表盘上限

1个Project中最多可创建仪表盘数量。

100

400

仪表盘中图表上限

1个仪表盘最多可包含统计图表数量

200

400

快速查询上限

一个Project中最多可创建快速查询数量。

100

400

导出任务上限

一个Project中最多可创建导出任务数量。

100

400

导入任务上限

一个Project中最多可创建导入任务数量。

100

400

定时SQL上限

一个Project中最多可创建定时SQL数量。

100

400

加工任务上限

一个Project中最多可创建加工任务数量。

100

400

告警上限

一个Project中最多可创建告警数量。

100

400

订阅任务上限

一个Project中最多可创建订阅任务数量。

100

400

project写入流量上限(GB/min)

一个Project在1分钟内所有Logstore写入流量的总和。

100

200

project写入次数上限(万次/min)

一个Project在1分钟内所有Logstore写入次数的总和。

60

200

project读取次数上限(万次/min)

一个Project在1分钟内所有Logstore读取次数的总和。

60

200

日志跨域传输加速

如果需要远距离日志传输,例如从海外向中国内地的地域写入日志,可以开启传输加速功能。传输加速利用全球分布的云机房,将全球各地用户对日志服务的访问,经过智能路由解析至就近的接入点,使用优化后的网络及协议极大地提升访问速度,传输加速按照实际传输的数据量进行计费。

控制台

开启传输加速

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 在Project页面的项目概览-访问域名-传输加速域名中单击开启,阅读对话框的提示,然后单击确认修改

  3. 开启传输加速后在后续使用Logtail进行日志采集,以及执行数据加工任务时能够提高传输速度。

API

  1. 首先使用PutProjectTransferAcceleration - 配置传输加速

  2. 在后续使用时将endpoint配置为传输加速域名才能获得加速效果。传输加速域名仅支持HTTP/HTTPS协议的API接入,暂不支持Kafka、GRPC等协议接入。在不需要传输加速的场景中,建议使用服务接入点以减少传输费用。

        /**
             * 本示例从环境变量中获取AccessKey ID和AccessKey Secret。
             */String accessId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
            String accessKey = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
            /**
             * 日志服务的服务接入点,使用传输加速域名。
             */String endpoint = "log-global.aliyuncs.com";
            /**
             * 创建日志服务Client。
             */static Client client = new Client(host, accessId, accessKey);

资源分组管理

当您需要对Project进行分组管理时,可以使用标签或资源组来区分Project,标签与资源组的不同之处在于分组层级。其中标签是Project层级下分组管理的方式,资源组则是在阿里云账号下进行资源分组管理的一种机制。

设置资源组

一个Project只能归属于一个资源组。

控制台

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 鼠标悬浮在Project页面的项目概览-资源组信息-资源组ID上,单击修改,选择资源组。

API

ChangeResourceGroup - 修改资源组

设置标签

控制台

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 在Project页面的项目概览-标签-中单击编辑,在编辑标签面板中设置标签。

API

TagResources - 绑定标签

设置自定义域名

当您需要将公网域名换为自定义域名时,可以按如下方式设置自定义域名。完成后即可在接口调用中使用自定义域名作为endpoint。

控制台

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 鼠标悬浮在Project页面的项目概览-基础信息-自定义域名上,单击设置,在设置自定义域名面板,配置域名注册快速入门,然后单击绑定

  3. 云解析DNS产品控制台,做CNAME解析,域名绑定才能生效。记录值填写Project页面的项目概览-基础信息-访问域名中的 公网域名,详细操作,请参见CNAME 记录

API

CreateDomain - 创建自定义域名

Project资源监控与运维

如果您需要获取Project内的资源操作日志(创建、修改、更新、删除)和任务执行日志(定时SQL、数据导入、数据投递),Logstore内消费组消费延时日志以及Logtail的错误、心跳和统计日志,可以使用服务日志功能。

控制台

  1. 登录日志服务控制台,在Project列表区域,单击目标Project。

  2. 在Project页面的服务日志页面,单击开通详细日志,在修改服务日志配置面板,选择需要开通的服务日志与服务日志存储的Project。

    • 详细日志:完整操作日志,按量收费。

    • 重要日志:计量、消费组延迟和Logtail心跳日志等,免费。

    • 任务运行日志:数据导入、定时SQL、投递任务的运行日志,免费。

    • 日志存储位置:选择已存在的Project或者自动创建Project进行存储。

更多信息

Project中存储不同类型的数据需要创建不同的Store,具体请参考管理Store

上一篇: 资源管理 下一篇: 管理Store
阿里云首页 日志服务 相关技术圈