统计数据

管理员指南的这一章提供了一个关于开放期刊系统(OJS)统计的总体概述，以及开放专论出版社(OMP)和开放预印本系统(OPS)的扩展，因为它们属于系统管理员。如果您正在寻找各种可用报表类型的具体描述，以及如何生成自定义报表，请阅读在学习OJS指南的统计部分．

OJS，OMP和OPS的统计功能，可以查看不同的数字，表示活动，访问和你的网站的各个方面，包括文章和抽象的观点，编辑活动的下载和用户数的角色分开。本指南提供了OJS 2个统计和OJS 2统计方法用在统计框架的信息，各种统计的相关配置，日志文件，和传统的信息。

本章的发展是由加拿大政府通过加拿大遗产和加拿大学术期刊协会/加拿大时事评论协会资助的。188bet手机网公共知识项目为该项目的发展提供了额外的实物援助。

统计框架简介#

在考虑文章使用指标时，“什么是视图”似乎是一个足够直接的问题，但有许多方法可以提供——或使之复杂化——答案。回答这个问题取决于使用了哪种计数机制(例如，谷歌Analytics vs.日志文件命中vs.过滤指标)，是否尝试检查历史数据跨越不同的方法，以及这些方法是否配置正确。

本手册主要用于解释，在一些细节，如何配置，使用，和故障排除PKP的使用统计框架。它还包含了OJS支持的其他统计收集方法的一些信息。

配置统计框架#

在大多数情况下，Statistics Framework应该能够“正常工作”，特别是在新安装时。同样，您也可以使用许多配置选项，它们应该在安装或升级后进行检查。您还需要设置某种机制来运行计划任务，以便定期处理使用率统计数据。

期刊管理人员和编辑须知:以下大部分步骤将被认为是专家级的，只应由场地管理员和系统管理员进行。如果您对这里提出的更高级的问题有疑问，请咨询您的服务提供商。这方面的主要例外是下一节描述的Statistics Display选项。如果您想在文章摘要页面上公开显示文章使用统计信息，您可以启用此选项。

有三个配置步骤，你将不得不考虑：在配置使用统计插件，配置计划任务，并配置区域的数据跟踪，如果你想跟踪区域数据。（OJS可以跟踪国家，区域和城市的数据。）

本节仅适用于使用OJS 2.4.3+和OJS 3.0+的用户。旧版本的OJS没有这个框架，也不需要配置。

配置使用统计插件#

OJS 2.4.3+和3+包括一个通用的使用统计插件，负责如何在系统中记录这些统计信息。插件的默认配置是合理的，并且在大多数情况下都是有效的，尽管你需要在安装或升级OJS后检查它们。要启用使用数据的收集，请确保启用该插件。

插件设置可以在OJS 2的用户主页找到> Journal Manager > System Plugins > Generic Plugins > Usage Statistics plugin > settings。

插件设置可以在OJS 3中找到:Dashboard > settings > Website > Plugins > Generic Plugins > Usage Statistics plugin > settings。

我们不会详细介绍插件的每一个配置选项，但我们建议如下作为一个合理的设置:

• 如果尚未启用，检查框插件名称的右侧。
• 点击插件旁边的蓝色箭头，然后点击设置．
• 启用“创建日志文件”(如果还没有启用)。
• 不要使用“解析日志文件Regex”选项，除非您知道自己在做什么。
• 保留“压缩存档”选项，除非考虑服务器空间(请参阅下面的故障排除部分)。
• 关闭“资料私隐选项”，除非你能按照所提供的说明操作。
• 启用“城市”和“地区”选项，并按照下面的配置区域数据跟踪部分进行操作。
• 如果在你的OJS安装中可用，如果你想要基本的摘要和galley视图在文章登录页面可用，考虑启用Statistics Display Options。有关更多信息，请参见上面的显示使用情况统计。

配置调度任务#

一旦Usage Statistics插件被启用，你需要确保统计数据被记录并作为OJS的“计划任务”的一部分进行处理。有两种方法可以做到:

1.启用OJS Acron插件#

该插件可以在OJS 2中找到:用户主页> Journal Manager > System Plugins > Generic Plugins > Acron plugin。

该插件可以在OJS 3中找到:Dashboard > Settings > Website > Plugins > Generic Plugins > Acron plugin。

一旦启用，这个插件应该会导致日志文件的处理(以及其他计划任务，如审查和订阅提醒)。

2.配置服务器端cron作业#

这是一个更高级的选项，需要对服务器进行命令行访问，应该只由经验丰富的系统管理员进行配置。你需要创建一个cron作业，它将在你的OJS系统目录中触发以下脚本:

工具/ runScheduledTasks.php

该脚本预计伴随的参数在一个指向XML文件的形式描述了计划任务。该文件将取决于您是否使用OJS日志文件，外部的日志文件（例如，Apache日志文件），或OJS日志文件与自动升级过程不同。大多数期刊将使用简单的“OJS日志文件”选项（如下选项1）。完整的命令如下，将不得不被添加到服务器cron作业，最好让他们每天运行。

要运行的命令

在配置了Acron插件或cron作业之后，应该开始处理统计数据。它们只在设置的时间进行处理:如果使用Acron插件，则每24小时处理一次;如果正在使用cron作业，则按照cron作业中设置的频率进行处理。等待一定的时间，然后检查统计数据是否可用。如果不是，请转到故障排除部分。

配置区域数据跟踪#

Usage Statistics插件还可以跟踪区域数据，包括游客国家、地区和城市信息。这是可选的。在决定是否收集这些信息时，要考虑存储地理数据可能会占用大量空间，并且在生成报告时还会增加处理时间。如果在尝试生成报告时遇到空间问题或超时，则可能必须增加磁盘或内存资源或禁用地理日志记录。如果您没有立即启用和配置地理跟踪，而是决定稍后启用它，那么您将不得不重新处理旧的日志文件，以便在旧的使用统计中使用该数据。

为了追踪这些信息:

1. 注册GeoIP帐户，按照GeoIP的网站．
2. 使用量统计插件必须像上面描述的那样启用区域和城市选项。
3. 下面的服务器端配置也必须到位。这一步需要到服务器的命令行访问，除非这项工作已经完成的国家和地区的信息将无法正常工作。
   1. 在服务器上打开一个shell提示符。
   2. 进入OJS安装基础目录。
   3. 使用从GeoIP为wget命令获取的URL执行以下命令:

$ gunzip geolitec. dat.gz $ mv geolitec. dat plugins/generic/usageStats

处理日志文件#

基本(默认)#

默认情况下，OJS会自动开始将使用事件记录到自己的访问日志文件中。它每天也会自动处理这些文件。例如，如果你在今天下午2点安装了OJS，那么今天的使用事件的处理将在明天下午2点开始。如果您不更改任何设置，将在没有任何输入的情况下继续执行。

先进的#

如果你真的想控制你的统计处理，你可以去Generic Plugins类别的Plugins管理页面，搜索Acron插件。如果禁用，自动处理将停止。请阅读以下步骤以了解如何手动触发处理。

OJS需要处理这些文件，以便能够从它们中检索统计数据。这个过程可以使用File Loader任务工具来完成，该工具随Usage Statistics插件一起提供。

文件加载器#

文件加载器任务实现一个进程来可靠地处理所有文件处理。它有4个文件夹:stage, processing, archive, and reject。每次文件加载器运行时，它都会搜索stage文件夹中的文件。如果有，它将移动一个文件到处理文件夹并开始处理它。如果出现任何错误，它将向系统管理员发送一封电子邮件，提供有关错误的有价值的信息，并将文件移动到拒绝文件夹。如果处理进展顺利，那么它将把文件移动到存档文件夹。它将继续这个过程，直到stage文件夹中没有其他文件为止。

流程#

文件加载器是一种定时任务工具，可以定期使用cron或其他系统任务管理工具。运行此任务的命令取决于你愿意使用哪个进程:

文件加载器任务进程:

这应该从OJS安装基目录执行。

进程1和3需要将文件移动到stage文件夹中(无论它是apache日志文件还是OJS日志文件)。进程2已经自动将OJS日志文件移动到stage文件夹中，所以命令只需要执行即可。

其他一切都由文件加载器任务处理。如果该任务没有使用cron或类似机制安排自动执行，则必须手动运行。

注意，对于您选择的任何进程，您都可以随时将文件移动到stage文件夹中，即使是在计划任务运行时。您还可以在stage目录中移动任意数量的文件。决定将文件移动到stage目录所需时间的主要是更新统计数据的必要性。

唯一的问题是不推荐是将系统(OJS或apache)仍在使用的日志文件移动到日志访问。OJS已经控制了进程2，但对于进程1和3，你必须小心。不推荐这样做，因为重新处理同一个文件会浪费处理时间。您可以通过注意apache日志文件的轮换(只移动已经轮换过的文件)，或者，如果您使用OJS日志文件，不移动文件名为当前日期的文件，来保证您不会这样做。

如果您确实需要同一天更新的统计信息，您仍然可以复制文件(而不是移动文件)，这样系统就可以继续记录对同一文件的更多访问。但是，您将能够处理已经记录的内容。系统可以处理文件的重新处理(见下一个主题)，只要文件名没有改变，文件的最终复制版本包含所有访问日志记录。

用法示例#

假设我们有以下三个场景，都有一个每天调用文件加载器任务工具的cron作业:

1. 日志管理器使用apache日志文件，每周轮换;日志文件以发生文件旋转的日期命名(例如:20130929-access.log);JM使用文件加载器任务进程3。
2. 日志管理器使用每天轮换的OJS日志文件，在他们的文件名中有他们被用于日志访问的日子;JM使用文件加载器任务进程1。
3. 与上一个场景相同，但JM使用文件加载器任务流程2。

在场景1中，如果JM不能将apache日志文件循环配置为更短的时间，他们可以在每次需要处理新的统计信息时将20130929-access.log文件复制到usageStats/stage目录。系统每次都会删除该文件处理过的所有数据，并重新处理所有内容。这就是为什么这个过程不如更小的日志文件循环周期那么高效的原因。在20131006天，将发生日志轮换，JM最终可以将20130929-access.log文件移动或复制到阶段目录，以便还可以处理上次文件暂存和日志轮换之间记录的统计信息。

在场景2中，JM可以每天移动一个文件，总是从前一天移动文件。周一，他们可以同时移动两个文件(从周六和周日)。它们将在访问和可用统计数据之间有一小段时间(一周的大部分时间只有一天)，并且将避免重新处理相同的访问日志条目。

在场景3中，JM不需要移动文件。每次执行文件加载器任务时，系统将自动获取尚未处理的日志文件，并将它们分级，并开始处理每个日志文件。

在场景1和2中，如果由于某种原因，JM一整周都不能移动文件，那么在下一个机会中，他们可以一次性移动所有文件。计划的任务将逐个处理，直到阶段目录再次为空。

重新处理日志文件#

如果您需要重新处理任何日志文件（如果一个新的机器人列表或地理位置数据库被引入或您的固定拒绝的文件里面的问题），你可以将它们移动回阶段过程。即使他们里面的“拒绝”或“已归档”的目录。他们将被处理，并从这些日志中任何现有的数据将被重新处理数据替代。

重要的是，在文件被成功处理并移动到存档文件夹后，它的文件名会被保留。文件名用于跟踪统计数据和从中检索数据的文件。出于同样的原因，所有日志文件必须具有唯一的文件名。如果您使用的是OJS日志文件，则不必担心这个问题。但是如果您使用apache访问日志文件，请确保在文件名中使用一些独特的内容，例如日期。

常见问题#

以下是关于OJS和统计最常见的问题和答案。这并不是一个详尽的清单。如果您遇到了更多的问题而又不知道答案，请通知您的托管服务提供商或查看PKP社区论坛<金宝搏官网登录https://forum.www.szfbm.com>，看看是否还有其他人遇到过同样的事情。

为了确保准确的使用报告，我能做的最好的事情是什么?#

首先，升级到OJS 2或3的最新稳定版本。还可以考虑重新处理日志(请参阅上一节)处理日志文件)．

其次，找出你想要的统计数据，并使用相同的方法每次获取它们。如果您正在使用自定义报表生成器，请确保您保存了它提供给您的URL，以便您可以重新运行特定的报表。

您对使用哪些报告有建议吗?#

这完全取决于您需要什么类型的数据。对于遗留数据(即来自前ojs 2.4.3的数据)，Views报告提供了文章使用情况的总体快照，并且它是最容易理解的指标。

对于更近期的数据，我们推荐使用自定义报表生成器。它非常复杂，但它可以提供非常广泛的数据，并充分使用统计框架。只要确保你坚持使用它!我们包含了一套很棒的提示和技巧，由我们在约克大学图书馆的同事Andrea Kosavic编写，在本文档的最后特别关注自定义报告生成器。

我最近从旧版本的OJS升级，我想使用改进的统计框架访问之前的升级。我能这样做吗?#

是的，但前提是你有升级之前的网络服务器日志。如果你在升级之前有这些web服务器日志(例如，Apache access_log文件)，你可以处理这些(参见上面的处理日志文件)。如果你没有这些旧的日志，你就很不幸。

如果您的日志文件是OJS3安装中需要重新处理的OJS2日志文件，则需要一些开发工作来重新构建日志文件并将文件id附加到所有度量url—在OJS中没有用于这项工作的内置工具。最后，值得一提的是，如果您重新处理旧日志文件，并且日志的URL从那时到现在发生了变化，日志文件中的URL将不匹配您的OJS安装的“基础URL”，这些指标将不计算在内。如果您想重新处理日志文件，请查看旧的日志文件，并确保url仍然与日志匹配。这包括协议(http或https)。它必须匹配确切地否则度量将不被计算在内。

同时,值得注意的是,你仍然可以检索历史,基本用法指标使用遗留报告(仅在橙汁2——而不是橙汁3)。这些不是全面的新指标,并且机器人访问和multi-clicks包括,但他们仍然是一个很好的表示的一般用法。

我曾见过一些OJS杂志在文章登陆页面显示漂亮的文章使用指标。我该如何配置呢?#

此选项仅适用于OJS 3。使用使用统计插件。有关如何启用和配置Usage Statistics Plugin的说明，请参阅本文档的前一节，配置使用统计插件．

如何按院校查询使用情况?#

这在OJS中是不可能实现的，但在未来将会实现。

如果我替换一个galley文件的文章，下载计数将重置为0?#

OJS基于问题、文章和厨房的内部id收集统计信息。

如果您替换了一个PDF文件的galley, galley ID将不会改变。这意味着，galley的下载统计数据将继续在文件的两个版本中积累。

如果您从一篇文章中删除了一个galley，然后又为该文章添加了一个新的galley，那么这个新的galley将会有一个新的ID。文章视图的累积统计信息将保持不变，但galley文件的使用统计信息将从0重新开始。旧厨房的历史统计数据将保留在指标中，除非您将访问日志重新构建到新指标中。随着时间的推移，新的统计数据将被收集到新的厨房。

具体影响也因报告而异，因为报告所提供的信息是关于问题、文章、厨房，还是这些项目的组合。

常见的统计问题#

这些是在尝试生成使用报告时最常遇到的问题，并提供一些建议的解决方案。

我已经将OJS从OJS < 2.4.3升级到一个更新的版本，现在我的使用统计数据似乎下降了。它们还没有完全消失，但似乎有下降的趋势。这是怎么呢#

统计框架现在按照COUNTER Project的行为准则过滤视图。具体地说:

1. 如果有人在30秒内多次重新加载页面或下载文件，OJS只注册1次查看。
2. OJS过滤掉已知的机器人和爬虫视图。

这将导致更低的总体使用指标。下降幅度应该不会太大，但可能会很明显。

COUNTER项目总是在他们的规范中添加新的机器人，而OJS每次发布时都会跟踪这个规范。

我已经生成了一个报告，除了列标题之外，它不包含任何数据。#

可能是您的一般统计配置有问题。您应该按照下面的“配置”一节回顾这一段。

当我下载定时视图报告时，似乎我的总Galley视图实际上是他们应该的两倍。例如，如果我有2个PDF下载，没有其他Galley, Total Galley Views的值是4。#

这是OJS 2.4.5中的一个已知bug。解决方案是升级，这将立即解决问题。您不需要重新处理统计数据来解决这个问题。

摘要视图计数看起来还可以，但最近一些galley文件下载出现低或不存在。#

答:如果你正在使用OJS 2.4.8.0，这是一个bug。要解决这个问题，您必须升级到OJS 2.4或OJS 3的最新版本，并重新处理日志。

这些报表——特别是定时视图报表、使用统计报表和自定义报表生成器——有一些数据，但似乎在较早的日期停止或不完整。我知道我们最近有更多的点击率，但它们没有出现。#

有两个可能的原因:

原因1:在某个时间点，统计处理计划任务被停止。如果你的OJS实例已经被系统管理员从一个服务器迁移到另一个服务器，或者OJS已经升级，但是它的配置没有被检查，就会发生这种情况。你可以用一些(非常技术性的)方法来证实这一点:

1. 查看一下files_dir中的usageStats文件夹。如果您看到大量的日志文件文件/ usageStats / usageEventLogs /或文件/ usageStats /阶段时，计划任务不运行。
2. 看一下指标mysql数据库中的表。如果它是空的，或者如果指标似乎已被记录，但在特定日期停止，则计划任务没有运行。

这个问题的解决方案是检查您的配置和再处理统计数据，如下面的配置部分所示。

原因2:报告达到了报告插件的5,000行限制。通过查看.csv报告，这一点应该很明显:如果它停在第5000行左右(通常停在第5006行左右，因为报告顶部有一些额外的行)，那么这就是问题所在。这里的解决方案是缩小您试图提取的数据量，例如通过限制日期跨度和下载多个报告。您可以手动合并多个报表。请注意:此问题仅适用于OJS 3.1.1及以上版本。在OJS 3.1.2中删除了5000行限制。

问:我试图使用自定义报表生成器下载区域信息，但我在我的报表中没有看到这些。

答:区域数据跟踪没有正确或完全配置。请参阅下面的配置部分。

当我尝试下载的报告，得到了一个空白页面，500错误，或PHP内存限制错误（例如，“内存限制累死......”），而不是报告下载。#

当您试图下载的数据量超过服务器的传输能力时，就会发生这种情况。这可以通过减少一次性提取的数据量(例如，在多个日期范围内下载报告)或增加问题资源(例如。PHP的memory_limit或max_execution_time参数)。后者只能由系统管理员执行。

我需要一些关于处理、再处理或故障排除日志文件的指导。#

看到处理日志文件．

《OJS 2》中的Legacy Statistics & Statistics#

如果您的日志仍然使用OJS 2或从OJS 2升级到OJS 3，您将可以访问遗留报表(主要是定时视图报表)，这一节将描述。本节还解释了OJS中统计方法的变化，以及OJS 2中统计的一些具体信息。

OJS统计方法:一些历史#

OJS记录了自OJS 2发布之初的文章使用情况。从那时到现在，用于统计指标的方法经历了一个重大变化。这一变化是理解如何审查和管理历史统计数据的关键。

OJS 2.0 -> 2.4.3:#

OJS 2.4.3之前的版本以非常基本的方式统计浏览量:它们只记录文章登陆页面和galley文件的页面浏览量和文件下载，不过滤机器人浏览量/下载、多次点击等。这些视图记录在一个简单的数据库表中，并在OJS 2.4.2及以下通过“视图”报告表示。度量仅用于抽象/着陆页面和galley下载，并且仅跟踪一个方面:项目是否被查看或下载。这些计数被认为是准确的，尽管可能不代表实际的读者，如机器人视图，爬虫索引，和潜在的作者或访问者滥用(例如。multi-click)没有被过滤。

新方法:OJS 2.4.3+和3.0+#

从2.4.3版开始，Open Journal Systems使用了一种新的结构来收集统计信息和生成报告。这些指标计算抽象视图和galley视图、查看日期以及地区信息，如国家和城市(如果配置正确的话)。除了文章指标，问题和主页视图也包括在内。最后，根据COUNTER Project处理规则过滤这些指标，以便在默认情况下过滤多次点击和bot视图。

了解你所拥有的:关键要点#

下面描述了各种OJS迭代的用户可以访问的数据。OJS版本可以由期刊工作人员通过访问About > About this Publication System (OJS 2)来确定。

• OJS 2.4.2或以上版本:
  • 度量标准基于旧的度量方法。对于每个摘要或厨房视图，只记录简单的文章视图计数。这些不会被任何COUNTER Project筛选规则过滤。
  • 这些可从日志管理>统计和报告下的查看报告中获得。
  • 您还可以访问一个基本的定时视图报告。这个报告，如果在预OJS 2.4.2或更早的安装版本中可用，应该被认为是有bug和不可预测的。它不应该被使用。
  • 建议进行升级，以便今后收集更好的指标。(注意，至少在默认情况下，升级不会在升级日期之前为您提供更好的指标。有关重新处理旧指标的更多信息，请参阅FAQ部分。)
• OJS 2.4.3或更新版本:
  • 度量是基于上面描述的新度量方法。
  • 如果这个OJS实例已经在某个点上从pre-OJS 2.4.3升级，你也可以访问遗留的视图报告(当你使用早期版本时收集的数据)。
  • 所有报告都可以从Journal Management > Stats和reports中获得。
  • 更新刊物须知:
    • 遗留的视图报告仅用于归档目的。它提供了在采用2.4.3之前的使用记录。在采用OJS 2.4.3之后，它没有记录新的视图。
    • 使用新度量方法的新报表(定时视图报表、自定义报表生成器等)将只包括从升级日期开始的度量。
    • 为了完全理解内容的视图计数，您必须同时考虑遗留报表和新报表。
  • 重要的BUG笔记:
    • OJS 2.4.5中有一个bug，导致一些指标计数翻了一番。有关更多信息，请参阅FAQ和经常遇到的问题部分。
    • OJS 2.4.8.0中有一个错误，导致一些文件视图没有被正确记录。有关更多信息，请参阅FAQ和经常遇到的问题部分。
    • 如果你的OJS实例目前在任何一个版本上，我们强烈建议升级(并且，可选地，重新处理你的统计数据-见附录B:处理日志文件)。
• 3.0或更新:
  • 您将拥有基于上面定义的新度量方法的度量。
  • 所有指标都可以通过工具> Statistics从用户仪表板上获得。
  • 更新刊物须知:
    • 如果你使用的OJS 3是一个OJS实例的升级，它有旧的视图报告数据(即:你的安装开始于OJS 2.4.2之前)，旧的视图报告数据将不再可下载。您应该在升级之前下载并存储这些数据。

Legacy Report: Timed Views Report#

可用性:仅OJS 2

CSV格式:

描述:该报告提供了文章和厨房使用的总体使用指标。必须指定日期跨度。它有一个遗留和非遗留模式可用。这是唯一一份以这种方式运作的报告。

使用:下载遗留或非遗留定时视图数据。

请勿使用:在OJS 3.0+下载数据，因为它已经不存在了。相反，使用自定义报表生成器。

特别指出:

• 由于OJS处理指标的方式，报告几乎肯定不包括今天的数据，所以尝试只报告今天的日期可能会返回一个空报告。
• 该报告可以为预ojs 2.4.3安装提供可选的遗留数据。如果您正在寻找OJS 2.4.3升级之前的定时视图数据，请选择“包括遗留数据”选项。

示例数据(为清晰起见而编辑):

In the sample below, which was generated for the date span March 29 2017 - March 30 2017 (i.e., 1 day), we can see that the article “Amusing Ourselves to Death” was quite highly viewed, with 2 abstract views and 11 total galley views (3 PDF and 8 HTML). The “Comobility” article only had its abstract viewed once.Arunachal Pradesh，

进一步的资源#

项目计数器:https://www.projectcounter.org/

使用Cron:https://help.ubuntu.com/金宝搏官网登录community/CronHowto

PKP社金宝搏官网登录区论坛(后续问题):https://forum.www.szfbm.com