442      小米MIX

项目（Project）__基础概念_用户指南_日志服务-阿里云

项目（Project）是日志服务中的资源管理单元。它管理着用户的所有日志库（Logstore），采集日志的机器配置等信息，同时它也是用户访问日志服务资源的入口。具体来说，Project提供用户如下功能：

• 帮助用户组织、管理不同的Logstore。在实际使用中，用户可能需要使用日志服务集中收集、存储不同项目、产品或者环境的日志。用户可以把不同项目、产品或者环境的日志分类管理在不同的Project中，方便后续的日志消费、导出或者索引。同时，Project还是日志访问权限管理的载体。
• 提供用户日志服务资源的访问入口。每创建一个Project，日志服务会为该Project分配一个独有的访问入口。该访问入口支持通过网络写入、读取及管理日志。

本章接下来将详细解释如何操作和使用日志服务Project。

创建项目

目前，日志服务仅提供控制台方式创建Project。你可以参考项目操作了解如何使用控制台创建项目。在创建项目时需要注意如下几点：

• Project的名字长度在3~63字节以内，只能包括小写字母、数字、短横线(-)，必须以小写字母或数字开头和结尾。如果你选择的Project名字不符合要求，系统会及时提醒。
• Project的名字全局唯一（所有阿里云Region内）。如果你选择的Project名称已经被别人使用，系统会及时提醒。
• Project创建时需要指定所在的阿里云Region。你需要根据需要收集的日志来源和其他实际情况选择合适的阿里云Region。如果你需要收集来自阿里云ECS虚拟机的日志，建议在ECS虚拟机相同的Region创建Project。这样既可以加快日志收集速度，还可以使用阿里云内网（不占用ECS虚拟机公网带宽）收集日志。Project一旦创建完成则无法改变其所属Region，且日志服务目前也不支持Project的迁移，所以请谨慎选择Project的所属Region。

1. 一个用户在所有阿里云Region总计最多可创建10个Project。

访问项目

成功创建完Project后，日志服务后端即给该Project分配了唯一的访问入口。该访问入口的格式如下：

<project_name>.<region_endpoint>

其中，<project_name>即为创建的Project名称，而<region_endpoint>为Project所属阿里云Region的日志服务入口。目前已有多个阿里云Region已开通日志服务（服务入口），现假设用户在“华东 1 (杭州)”Region创建了名称为’myslsproject’的Project，则该项目的访问入口为：

myslsproject.cn-hangzhou.sls.aliyuncs.com

如果在阿里云的ECS机器内使用日志服务API，还可以使用内网服务入口（使用内网服务入口访问日志服务不消耗ECS公网流量，可以节约宝贵的ECS公网带宽），各个Region的日志服务内网根服务入口。如上例，其内网访问地址如下：

myslsproject.cn-hangzhou-intranet.sls.aliyuncs.com

在获得该访问入口后，用户就可以通过日志服务的API或者SDK来访问该Project下面的日志库、向具体日志库写入日志，消费日志内容或者查询日志信息。同时，你也可以通过日志服务的控制台列出Project下的所有日志库，创建日志库等。具体可以参考项目操作。

管理项目

如前所述，Project为日志服务的资源管理单元，用户可以通过Project来管理自己的各种日志库，需要采集日志的机器。具体来说，用户可以如下管理日志服务的Project：

• 创建和删除Project内的日志库（Logstore）。日志库为日志服务内的日志存储单元，它用于存储一类日志。而一个用户实际项目中可能需要收集的日志类型可能有多种，如前端Web服务器的访问日志（access log），后端应用程序生成的应用日志（application log）等。用户则可以在Project创建独立的日志库并把不同类型的日志写入不同的日志库。关于日志库的更多信息请参考管理日志库。
• 管理采集日志的机器。 用户的日志会在各个不同的日志源产生，其中最为常见的即为服务器。Project以“机器组（Machine Group）”的方式帮助用户管理需要采集日志的服务器。用户可以在一个Project中创建和删除机器组，同样机器IP把需要采集的服务器归类到相应的机器组中。一种常见的实践就是让需要写入一个Logstore的所有日志源（如所有前端Web服务器）加入到一个机器组进行管理。

目前，日志服务仅提供控制台方式帮助用户管理Project。你可以通过控制台完成如上所述的所有管理操作。具体可以参考项目操作。

删除项目

在某些情况下（如关闭日志服务，销毁Project的所有日志等），用户可能需要删除整个Project。日志服务允许用户在控制台上方便地删除整个Project。当用户的Project被删除后，其管理的所有日志数据及配置信息都会永久释放，不可恢复。所以，在删除Project前请仔细确认，避免数据丢失。具体如何在控制台删除Project，请参考项目操作。

最后更新：2016-08-29 11:33:32

  上一篇： 核心概念__基础概念_用户指南_日志服务-阿里云

  下一篇： 日志库（Logstore）__基础概念_用户指南_日志服务-阿里云