管理Project
项目(Project)是日志服务中的资源管理单元,是进行资源隔离与访问控制的主要边界。同时它也是您访问日志服务资源的入口。
基本概念
项目(Project)是日志服务的资源管理单元,用于资源隔离和控制。
Project中可包含Logstore、MetricStore和机器组等资源,同时它也是您访问日志服务资源的入口。建议使用不同的Project管理不同的应用、产品或项目中的数据。具体说明如下:
组织、管理不同的Logstore或MetricStore:在实际使用中,您可能需要使用日志服务采集及存储不同项目、产品或者环境的日志。您可以把不同项目、产品或者环境中的日志分类管理在不同Project中,便于后续的日志消费、导出或者分析。
用于访问控制隔离:您可以为RAM用户授予指定Project的操作权限。
提供日志服务资源的访问入口:日志服务为每个Project配置一个独立的访问入口。该访问入口支持通过网络写入、读取及管理日志。关于访问入口的更多信息,请参见服务接入点。
创建Project
您可以通过创建项目来管理某一个应用的所有日志及相关的日志源。
控制台
登录日志服务控制台,在Project列表区域,单击创建Project。
配置Project:
所属地域:请根据日志来源等信息选择合适的阿里云地域。创建Project后,您无法修改其所属地域,且日志服务不支持跨地域迁移Project。如果您要采集ECS日志,建议选择与ECS相同的地域,实现通过阿里云内网采集日志,加快日志采集速度。
Project名称:Project名称在阿里云内全局唯一,创建后不可修改。
其余配置无需修改,使用默认值即可。
API
开启Project删除防护
重要数据对应的Project建议开启回收站功能,避免误删。开启后Project被删除将进入回收站,回收站中的Project进入静默状态,不支持读写,如静默后发现存在业务关联可快速恢复。回收站仅收取数据存储费用。
Project进入回收站后,默认保存7天,到期后自动执行删除操作。
控制台
开启回收站功能
登录日志服务控制台,在Project列表区域,单击目标Project。
在Project页面的项目概览-基础信息-Project回收站中查看状态,若为未开启,单击开启。
API
修改UpdateProject - 更新Project接口中的recycleBinEnabled。
Project资源删除与恢复
删除Project可能导致日志库的数据丢失,请确认Logstore,MetricStore、EventStore等数据无用或已做好数据备份。
删除Project的当天仍会产生存储等费用,次日停止计费。即您在删除Project的第三天不会再收到日志服务的账单。
控制台
删除前清理
无关联资源:
在弹性计算、存储服务、安全、数据库等多种阿里云云产品开通日志分析服务,会在日志服务控制台自动创建对应的Project和Logstore。如果不需要云产品日志,需要在对应云产品控制台关闭日志分析服务。确保Project与其他阿里云服务无关联。
无计费依赖:Project若为付费类型(如存储包、预留实例),需先退订或释放资源。
删除步骤
备份重要数据(可选)
Logstore数据备份:若Project中包含需保留的日志数据,需通过SLS的下载日志功能提前导出。
配置信息备份:记录Project名称、存储容量、访问控制等关键配置,避免删除后信息丢失。
执行Project删除
在Project列表中,单击目标Project对应的删除。
在删除Project面板中,输入Project名称并选择删除原因,然后单击确定。
警告删除Project后,其管理的所有日志数据及配置信息都会被释放,不可恢复。在删除Project前请慎重确认,避免数据丢失。
确认操作:阅读提示后,输入Project名称进行二次确认。
若目标Project已开启Project回收站功能,您可在Project列表的回收站Project中查看,Project进入回收站后,默认保存7天,在此期间您可以选择恢复或者彻底删除。
API
管理资源配额
当您的资源配额不足时,您可以根据实际需求调整Project的多个指标,包括logstore上限,shard上限,logtail采集配置上限,机器组上限等。
控制台
登录日志服务控制台,在Project列表区域,单击目标Project。
在Project页面的项目概览-基础信息-资源配额中单击管理,即可在资源配额面板中,调整目标资源的配额,然后单击保存提交申请。修改申请需要等待1小时左右完成。
日志跨域传输加速
如果需要远距离日志传输,例如从海外向中国内地的地域写入日志,可以开启传输加速功能。传输加速利用全球分布的云机房,将全球各地用户对日志服务的访问,经过智能路由解析至就近的接入点,使用优化后的网络及协议极大地提升访问速度,传输加速按照实际传输的数据量进行计费。
控制台
开启传输加速
登录日志服务控制台,在Project列表区域,单击目标Project。
在Project页面的项目概览-访问域名-传输加速域名中单击开启,阅读对话框的提示,然后单击确认修改。
开启传输加速后在后续使用Logtail进行日志采集,以及执行数据加工任务时能够提高传输速度。
API
在后续使用时将
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只能归属于一个资源组。
控制台
登录日志服务控制台,在Project列表区域,单击目标Project。
鼠标悬浮在Project页面的项目概览-资源组信息-资源组ID上,单击修改,选择资源组。
API
设置标签
控制台
登录日志服务控制台,在Project列表区域,单击目标Project。
在Project页面的项目概览-标签-中单击编辑,在编辑标签面板中设置标签。
API
设置自定义域名
当您需要将公网域名换为自定义域名时,可以按如下方式设置自定义域名。完成后即可在接口调用中使用自定义域名作为endpoint。
控制台
登录日志服务控制台,在Project列表区域,单击目标Project。
鼠标悬浮在Project页面的项目概览-基础信息-自定义域名上,单击设置,在设置自定义域名面板,配置域名注册快速入门,然后单击绑定。
在云解析DNS产品控制台,做CNAME解析,域名绑定才能生效。记录值填写Project页面的项目概览-基础信息-访问域名中的 公网域名,详细操作,请参见CNAME 记录。
API
Project资源监控与运维
如果您需要获取Project内的资源操作日志(创建、修改、更新、删除)和任务执行日志(定时SQL、数据导入、数据投递),Logstore内消费组消费延时日志以及Logtail的错误、心跳和统计日志,可以使用服务日志功能。
控制台
登录日志服务控制台,在Project列表区域,单击目标Project。
在Project页面的服务日志页面,单击开通详细日志,在修改服务日志配置面板,选择需要开通的服务日志与服务日志存储的Project。
详细日志:完整操作日志,按量收费。
重要日志:计量、消费组延迟和Logtail心跳日志等,免费。
任务运行日志:数据导入、定时SQL、投递任务的运行日志,免费。
日志存储位置:选择已存在的Project或者自动创建Project进行存储。
更多信息
Project中存储不同类型的数据需要创建不同的Store,具体请参考管理Store。