当您的应用出现异常情况的时候，可以通过查看实例和应用级别的日志来排查问题。EDAS提供了日志目录收藏、日志查看、日志搜索和日志下线的功能。

收藏日志目录

日志目录页面包含EDAS相关的默认日志目录，您可以收藏（添加）应用日志目录。收藏日志之后即可查看该目录下的实例日志，详情请参见查看实例日志。

在收藏日志目录时还可以将该目录添加到日志服务，以便在日志搜索页面查看和搜索该目录下的应用日志。

说明 收藏目录和取消收藏仅对日志目录可用。
  1. 登录EDAS控制台。
  2. 在左侧导航栏中单击应用列表，在顶部菜单栏选择地域并在页面上方选择微服务空间，然后在应用列表页面单击具体的应用名称。
  3. 在应用详情页面左侧的导航栏中选择日志管理 > 日志目录，然后在日志目录页面单击收藏目录。
  4. 在收藏目录对话框中输入应用日志目录，选择是否将该目录添加到日志服务，然后单击添加。
    输入应用日志目录时，请遵循以下要求：
    • 此目录必须在/home/admin目录下。
    • 完整目录中必须包含log或者logs。
    • 目录最后必须以斜杠/结尾，表示添加的是一个文件夹。

查看实例日志

在收藏了应用日志后，可以查看实例和应用级别的日志。

  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志目录。
  2. 在日志目录页面单击日志目录左侧的展开按钮>，然后在展开的日志文件列表的操作列单击在线查看。
    查看日志目录
    说明 日志框架配置的文件下的日志文件除了可以查看日志详细信息，还可以修改该日志文件的级别。 日志级别由低到高依次为：TRACE、DEBUG、INFO、WARN和ERROR。修改后，系统会将所设置的级别及更高级别的日志显示在页面下方。
  3. 在实时日志页面顶部单击ECS实例ID/名称/IP右侧的下拉箭头，选择实例，查看该实例中的日志详细信息。
    查看实时日志详细信息
    在页面右下角单击开启实时追加，可以一直加载文件的最新追加内容（类似于tailf命令的效果）。

将日志目录或文件添加到日志服务

日志服务提供了查看和搜索应用日志的功能。将日志目录或文件添加到日志服务后，即可查看和搜索应用日志。

在将日志目录或文件添加到日志服务时，还可以指定项目（Project ）和日志库（Logstore）。

  • 如果您已经在日志服务中创建了Project和Logstore，可以使用已有的Project和Logstore。
  • 如果您未在日志服务中创建Project和Logstore，可以新建Project和Logstore。EDAS将按edas-logstore-<日志文件的绝对路径>格式为您创建Logstore，如a-homeadminlogs。
说明 如果您为RAM用户，请先由云账号为RAM用户授权，详情请参见为RAM用户授予日志服务权限。
  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志目录。
  2. 在日志目录页面选择日志目录或文件，然后单击添加到日志服务。
    如果您将日志目录添加到日志服务，则该目录下的日志文件默认都添加到日志服务中。您只能基于该日志目录进行分布式搜索，而不能再对该目录下的具体日志文件进行分布式搜索。如果您想对具体日志文件进行分布式搜索，建议不要将整个目录添加到日志服务中。
  3. 在添加到日志服务对话框中确认日志目录并设置参数，然后单击确定。
    添加到日志服务
    • 应用日志目录：选择的日志目录，不可修改。
    • 来源方式选择新建：
      • Project：输入Project名称，推荐格式为edas-project-<region-id-timestamp>，如edas-project-cn-qingdao-。
      • Logstore：EDAS将自动按edas-logstore-<日志文件的绝对路径>命名方式为您创建Logstore，如a-homeadminlogs。
      • 日志路径：如果您需要当前目录下的部分日志文件，可以输入文件名的关键字或完整文件名。文件名称可以是完整名，也支持通配符模式匹配。
    • 来源方式选择使用已有：
      • Project：在下拉列表中选择已创建的Project。
      • Logstore：在下拉列表中选择已创建的Logstore。
      • 日志路径：如果您需要当前目录下部分日志文件，那么可以输入文件名的关键字或完整文件名。文件名称可以是完整名，也支持通配符模式匹配。

查看应用日志并进行分布式搜索

已收藏过该应用日志目录，并将该目录或文件添加到日志服务后，可以查看应用日志并进行分布式搜索。

说明 如果您为RAM用户，请先由云账号为RAM用户授权，详情请参见为RAM用户授予日志服务权限。
  1. 在应用详情页面左侧导航栏中选择日志管理 > 日志搜索。
    如果已经将某个日志文件添加到日志服务，也可以在日志目录页面日志文件列表的操作列单击搜索
  2. 在日志搜索页面日志文件右侧单击下拉箭头，在下拉列表中选择日志目录或日志文件。
  3. 查看应用日志。
    查看应用日志包括日志聚类、LiveTail和查询和分析。
  4. 输入关键字，对应用日志内容进行分布式搜索。

为RAM用户授予日志服务权限

如果您是RAM用户，需要通过子账号使用日志服务（包括将日志目录或文件添加到日志服务和查看应用日志和分布式搜索），还需要由云账号（主账号）在访问控制RAM中为RAM用户授权。操作步骤如下：

  1. 使用阿里云账号登录RAM访问控制控制台。
  2. 在左侧导航栏中单击用户，然后在用户页面的用户列表中找到您要授权的RAM用户，如doctest，在操作列单击添加权限。
    RAM访问控制查找用户
  3. 在添加权限页面选择权限下面的系统权限策略右侧的文本框输入log，单击AliyunLogReadOnlyAccess将该权限添加到右侧列表中，单击确定。
    说明 被授权主体会默认加载，无需设置。如果您需要同时给多个RAM用户授权，在被授权主体下面的文本框通过关键字搜索并添加。
    给RAM用户添加权限
  4. 在授权结果页面查看RAM用户和被授权的权限，确认无误后，单击完成。

将指定日志目录或文件从日志服务中移除

将指定日志目录或文件从日志服务中移除。移除仅仅是从日志服务中移除，实际的日志目录和文件仍然存在，并未删除。包含两个动作：

  • 将日志目录或文件从日志服务的采集规则中移除：移除后，日志服务将不再采集新的数据。

  • 将日志目录或文件从日志服务的采集规则中移除，并删除日志服务中的关联对象：移除后，日志服务将不再采集新的数据。并且当关联对象（Project和Logstore）不再被其它应用使用时，将会被从日志服务中移除。该操作将会导致Logstore中的数据被删除且无法回滚。

说明 默认日志目录不可以从日志服务中移除。
  1. 在日志目录页面选中某个日志目录或文件，然后单击从日志服务中移除。
  2. 在从日志服务中移除对话框中确认要移除的日志目录或文件，并根据实际需求选择是否选中删除日志服务中的关联对象，然后单击确定。
    删除日志服务中的关联对象将删除关联对象（Project和Logstore），即Logstore中的数据被删除。

取消收藏日志目录

取消收藏日志目录即移除指定的应用日志目录。移除后，该日志目录将不再显示在日志目录页面上，也不能再查看该目录下的实例日志，但并不会删除实际的日志目录及文件。

说明 默认目录也可以取消收藏。

在取消收藏日志目录时，还可以选择并从日志服务中移除。

  • 如果未从日志服务中移除，则可以查看该目录下的原有应用日志。
  • 如果从日志服务中删除，则不能再查看该目录下的应用日志。
  • 在日志目录页面选中某个日志目录，然后单击取消收藏。
  • 在取消收藏日志目录对话框中，确认要取消收藏的日志目录，选择是否并从日志服务中移除，单击确定。