brackets_initial_exploration.ipynb

{
  "cells": [
    {
      "cell_type": "markdown",
      "source": [
        "# Brackets Data Exploration\n",
        "The goal of this notebook is to identify key points in the current Brackets analytics logs to track an identify usage patterns\n"
      ],
      "metadata": {
        "id": "QP5CQRfxdzyB"
      },
      "id": "QP5CQRfxdzyB"
    },
    {
      "cell_type": "code",
      "execution_count": 1,
      "id": "61c57b0e",
      "metadata": {
        "id": "61c57b0e"
      },
      "outputs": [],
      "source": [
        "import json\n",
        "import datetime\n",
        "from collections import Counter\n",
        "import requests\n",
        "import os\n",
        "import matplotlib.pyplot as plt\n",
        "import numpy as np"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Loading the Data \n",
        "There are 15,311 log files that we need to analyze. We will check only the first 1,000 files."
      ],
      "metadata": {
        "id": "Z-Hm7HbHeyl5"
      },
      "id": "Z-Hm7HbHeyl5"
    },
    {
      "cell_type": "code",
      "source": [
        "%%capture\n",
        "!gdown 1Gjldh5ThKTG89BwmLMbXgfcR2RWUHjwq\n",
        "!unzip Copy\\ of\\ brackets.zip"
      ],
      "metadata": {
        "id": "MNLyPyYo9D7I"
      },
      "id": "MNLyPyYo9D7I",
      "execution_count": 2,
      "outputs": []
    },
    {
      "cell_type": "code",
      "source": [
        "len(os.listdir('./brackets'))"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "hqpS6JLjAQSe",
        "outputId": "b58d7c1c-bc32-4efb-8aa1-23051a5ff5db"
      },
      "id": "hqpS6JLjAQSe",
      "execution_count": 3,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "15311"
            ]
          },
          "metadata": {},
          "execution_count": 3
        }
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "path = './brackets/'\n",
        "c_data = []\n",
        "for filepath in os.listdir(path)[:1000]:\n",
        "  with open(path+filepath) as f:\n",
        "    data = json.load(f)\n",
        "    c_data.extend(data['clientAnalytics'][:-1])"
      ],
      "metadata": {
        "id": "3FH3eq-w-Y2T"
      },
      "id": "3FH3eq-w-Y2T",
      "execution_count": 4,
      "outputs": []
    },
    {
      "cell_type": "code",
      "execution_count": 5,
      "id": "2d84bce7",
      "metadata": {
        "id": "2d84bce7",
        "outputId": "967a60d4-d27a-44c4-a750-6542277e5ed6",
        "colab": {
          "base_uri": "https://localhost:8080/"
        }
      },
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "524358"
            ]
          },
          "metadata": {},
          "execution_count": 5
        }
      ],
      "source": [
        "len(c_data)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 6,
      "id": "bb1b0683",
      "metadata": {
        "id": "bb1b0683",
        "outputId": "2101b203-0779-407d-f14c-3b4b035b44aa",
        "colab": {
          "base_uri": "https://localhost:8080/"
        }
      },
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "dict_keys(['schemaVersion', 'accountID', 'appName', 'uuid', 'sessionID', 'unixTimestampUTC', 'numEventsTotal', 'events', 'geolocation'])"
            ]
          },
          "metadata": {},
          "execution_count": 6
        }
      ],
      "source": [
        "c_data[0].keys()"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "There are 524,358 client records in the 1000 log files. Each client records contains a unique identifier (uuid) and their geolocation (geolocation), the time the log was recorded (unixTimestampUTC), the number of events that were recorded (numEventsTotal), and a list of the events that took place."
      ],
      "metadata": {
        "id": "Iyy39f5bfJxU"
      },
      "id": "Iyy39f5bfJxU"
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Data samples"
      ],
      "metadata": {
        "id": "GXPLO1bjhge5"
      },
      "id": "GXPLO1bjhge5"
    },
    {
      "cell_type": "code",
      "source": [
        "c_data[72]"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "dKABg-waDU4d",
        "outputId": "6717406f-4733-4bc2-a141-8659e2f06156"
      },
      "id": "dKABg-waDU4d",
      "execution_count": 7,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "{'schemaVersion': 1,\n",
              " 'accountID': 'brackets',\n",
              " 'appName': 'brackets-prod',\n",
              " 'uuid': '857db5d5-0b8c-4ea5-8f93-38f1a46c0047',\n",
              " 'sessionID': 'b66pdzbp6e',\n",
              " 'unixTimestampUTC': 1658940286268,\n",
              " 'numEventsTotal': 25,\n",
              " 'events': {'usage': {'fileOpen': {'html': {'time': [0], 'valueCount': [1]}}},\n",
              "  'core-analytics': {'client-lib': {'loadTime': {'time': [0],\n",
              "     'valueCount': [{'1432': 1}]}}},\n",
              "  'PLATFORM': {'os': {'mac': {'time': [0], 'valueCount': [1]}},\n",
              "   'osLanguage': {'pl-PL': {'time': [0], 'valueCount': [1]}},\n",
              "   'bracketsLanguage': {'pl-PL': {'time': [0], 'valueCount': [1]}},\n",
              "   'bracketsVersion': {'2.1.2-17937': {'time': [0], 'valueCount': [1]}},\n",
              "   'AppStartupTime': {'AppStartupTime': {'time': [0], 'valueCount': [1]}},\n",
              "   'ModuleDepsResolved': {'ModuleDepsResolved': {'time': [0],\n",
              "     'valueCount': [1789]}}},\n",
              "  'PROJECT': {'numFiles': {'numFiles': {'time': [0], 'valueCount': [3]}},\n",
              "   'cacheSize': {'cacheSize': {'time': [0], 'valueCount': [41344]}},\n",
              "   'numProjectsOpened': {'numProjectsOpened': {'time': [0],\n",
              "     'valueCount': [1]}},\n",
              "   'ACTION_PROJECT_LOAD_TIME': {'ACTION_PROJECT_LOAD_TIME': {'time': [0],\n",
              "     'valueCount': [0]}}},\n",
              "  'FILE_STATS': {'openedFileExt': {'html': {'time': [0], 'valueCount': [9]}},\n",
              "   'workingSetFileExt': {'html': {'time': [0], 'valueCount': [6]}},\n",
              "   'openedFileEncoding': {'UTF-8': {'time': [0], 'valueCount': [9]}}},\n",
              "  'searchDetails': {'searchNew': {'searchNew': {'time': [0],\n",
              "     'valueCount': [0]}},\n",
              "   'searchInstant': {'searchInstant': {'time': [0], 'valueCount': [0]}}},\n",
              "  'THEMES': {'bracketsTheme': {'nebuleuse-theme': {'time': [0],\n",
              "     'valueCount': [1]}}},\n",
              "  'installedExtensions': {'nebuleuse-theme': {'1.0.0': {'time': [0],\n",
              "     'valueCount': [1]}},\n",
              "   'vscode-dark': {'0.9.1': {'time': [0], 'valueCount': [1]}},\n",
              "   'thizer.phpcompletion': {'1.1.7': {'time': [0], 'valueCount': [1]}},\n",
              "   'brackets-php-syntax-hint': {'1.1.6': {'time': [0], 'valueCount': [1]}},\n",
              "   'brackets-php-beautify': {'0.1.1': {'time': [0], 'valueCount': [1]}},\n",
              "   'hirse.brackets-prettier': {'1.2.0': {'time': [0], 'valueCount': [1]}}},\n",
              "  'EXTENSIONS': {'numExtensions': {'numExtensions': {'time': [0],\n",
              "     'valueCount': [6]}}}},\n",
              " 'geolocation': {'continent': 'Europe',\n",
              "  'country': 'Poland',\n",
              "  'city': 'Zduńska Wola'}}"
            ]
          },
          "metadata": {},
          "execution_count": 7
        }
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "This is a user from Poland. Here we see some things about his platform (mac), some of his usage (fileOpen), and other events."
      ],
      "metadata": {
        "id": "NW5LBkMxhzQo"
      },
      "id": "NW5LBkMxhzQo"
    },
    {
      "cell_type": "code",
      "source": [
        "c_data[528]"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "dOMbO3v0hpwo",
        "outputId": "a1490e94-6a58-4661-8095-6274236cf27c"
      },
      "id": "dOMbO3v0hpwo",
      "execution_count": 8,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "{'schemaVersion': 1,\n",
              " 'accountID': 'brackets',\n",
              " 'appName': 'brackets-prod',\n",
              " 'uuid': '6d0d5c60-10ab-4412-b386-90bf2ff1bdb9',\n",
              " 'sessionID': '5ldltnrpcd',\n",
              " 'unixTimestampUTC': 1665801863814,\n",
              " 'numEventsTotal': 2,\n",
              " 'events': {'usage': {'fileSave': {'html': {'time': [3], 'valueCount': [1]}},\n",
              "   'livePreview': {'open': {'time': [6], 'valueCount': [1]}}}},\n",
              " 'geolocation': {'continent': 'Asia', 'country': 'Japan', 'city': 'Chiyoda'}}"
            ]
          },
          "metadata": {},
          "execution_count": 8
        }
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "This is a user from Japan. Here only his usage events, (fileSave and livePreview), were recorded."
      ],
      "metadata": {
        "id": "8ImwC5RLigP_"
      },
      "id": "8ImwC5RLigP_"
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Count analysis\n",
        "Now we want to find what and how many types of events there are and hone in to some of the more interesting ones. We preidentified 'usage' to be an event of interest"
      ],
      "metadata": {
        "id": "5DDyn8FWgWTI"
      },
      "id": "5DDyn8FWgWTI"
    },
    {
      "cell_type": "code",
      "execution_count": 9,
      "id": "3cc1191c",
      "metadata": {
        "id": "3cc1191c"
      },
      "outputs": [],
      "source": [
        "event_types = Counter()\n",
        "usage_types = Counter()\n",
        "os_types = Counter()\n",
        "uuids = Counter()\n",
        "\n",
        "for client in c_data:\n",
        "    events = client.get('events', {'None':None})\n",
        "    event_types.update(events.keys())\n",
        "    uuids.update([client['uuid']])\n",
        "\n",
        "\n",
        "    if 'usage' in events.keys():\n",
        "        usage_types.update(events['usage'].keys())\n",
        "    if 'PLATFORM' in events.keys():\n",
        "        os_types.update(events['PLATFORM']['os'].keys())"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "### Users"
      ],
      "metadata": {
        "id": "u3-bzwaogxsx"
      },
      "id": "u3-bzwaogxsx"
    },
    {
      "cell_type": "code",
      "source": [
        "uuids.most_common(10)"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "nF0uyHdz95Tp",
        "outputId": "de7af965-4cbf-487a-d4f1-d47832f6a5a0"
      },
      "id": "nF0uyHdz95Tp",
      "execution_count": 10,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[('ec0cf5d0-0a90-4ec5-a3f8-37c658c245f9', 351),\n",
              " ('329ec3bc-e27f-437a-8c88-be65a1be4b6d', 318),\n",
              " ('a39afb12-991a-4f45-a882-58d531351ddd', 292),\n",
              " ('e2d0feb6-dca1-4705-854c-5f165484b58b', 291),\n",
              " ('03fe9fd3-6b68-4e26-8127-54f417f94b59', 274),\n",
              " ('dc8d5e83-6a7d-47a3-8450-2035fd4807fb', 244),\n",
              " ('408bca79-9a4f-4976-9785-c4f621e9ee72', 218),\n",
              " ('d5b91bc6-a064-4df8-b797-adbd2c237a4f', 209),\n",
              " ('f1d96cd3-dab9-40b1-9582-d228624fad40', 204),\n",
              " ('28a7acb1-8211-4035-8383-11da918513c1', 202)]"
            ]
          },
          "metadata": {},
          "execution_count": 10
        }
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "len(uuids)"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "FCxqQIWpjUYo",
        "outputId": "eff4dca2-8724-475c-f13e-baf6fdb53f45"
      },
      "id": "FCxqQIWpjUYo",
      "execution_count": 11,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "107509"
            ]
          },
          "metadata": {},
          "execution_count": 11
        }
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "From the 524,358 client records, we only saw 107,509 unique uuids. This means most records are from repeat users."
      ],
      "metadata": {
        "id": "5K9rtvL4g1II"
      },
      "id": "5K9rtvL4g1II"
    },
    {
      "cell_type": "markdown",
      "source": [
        "### Events"
      ],
      "metadata": {
        "id": "1pjOvzLrhIbY"
      },
      "id": "1pjOvzLrhIbY"
    },
    {
      "cell_type": "code",
      "execution_count": 12,
      "id": "ed5e70ac",
      "metadata": {
        "id": "ed5e70ac",
        "outputId": "2d193826-b77a-414a-e2d3-05e02d567687",
        "colab": {
          "base_uri": "https://localhost:8080/"
        }
      },
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "Counter({'PLATFORM': 81573,\n",
              "         'PROJECT': 81568,\n",
              "         'searchDetails': 81568,\n",
              "         'THEMES': 81568,\n",
              "         'EXTENSIONS': 81568,\n",
              "         'FILE_STATS': 57549,\n",
              "         'usage': 403834,\n",
              "         'core-analytics': 143606,\n",
              "         'installedExtensions': 27270,\n",
              "         'navbar': 8454})"
            ]
          },
          "metadata": {},
          "execution_count": 12
        }
      ],
      "source": [
        "event_types"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 13,
      "id": "3179e912",
      "metadata": {
        "scrolled": false,
        "id": "3179e912",
        "outputId": "10038632-5420-42a6-91f8-6e52080d99db",
        "colab": {
          "base_uri": "https://localhost:8080/"
        }
      },
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "Counter({'fileOpen': 205194,\n",
              "         'fileSave': 117458,\n",
              "         'fileClose': 54642,\n",
              "         'languageChange': 4200,\n",
              "         'livePreview': 42951,\n",
              "         'quickEdit': 1991,\n",
              "         'projectSettings': 864,\n",
              "         'languageServerProtocol': 1645,\n",
              "         'externalEditors': 6971,\n",
              "         'multiCursor': 9872,\n",
              "         'jsRefactor': 137,\n",
              "         'quickDoc': 550})"
            ]
          },
          "metadata": {},
          "execution_count": 13
        }
      ],
      "source": [
        "usage_types"
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "### Platform"
      ],
      "metadata": {
        "id": "7XqXoFTzj2JB"
      },
      "id": "7XqXoFTzj2JB"
    },
    {
      "cell_type": "code",
      "execution_count": 14,
      "id": "a3d8f513",
      "metadata": {
        "id": "a3d8f513",
        "outputId": "e43a464a-96c1-4661-c053-302d19e611af",
        "colab": {
          "base_uri": "https://localhost:8080/"
        }
      },
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "Counter({'mac': 28956, 'win': 52617})"
            ]
          },
          "metadata": {},
          "execution_count": 14
        }
      ],
      "source": [
        "os_types"
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "sum(os_types.values())"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "mtN39luSi8sy",
        "outputId": "e1eb340c-41b5-4440-bfde-b83968b091bc"
      },
      "id": "mtN39luSi8sy",
      "execution_count": 15,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "81573"
            ]
          },
          "metadata": {},
          "execution_count": 15
        }
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "Against 107,509 uuids, and assuming that the 81,573 are one-to-one for a uuid, then some uuids are missing a platform. "
      ],
      "metadata": {
        "id": "xlYMZtZmjzUB"
      },
      "id": "xlYMZtZmjzUB"
    },
    {
      "cell_type": "markdown",
      "source": [
        "## Timestamps"
      ],
      "metadata": {
        "id": "v4HgM4zbkX2-"
      },
      "id": "v4HgM4zbkX2-"
    },
    {
      "cell_type": "code",
      "source": [
        "timestamps = [c['unixTimestampUTC'] for c in c_data]"
      ],
      "metadata": {
        "id": "UpyG5OwE9lca"
      },
      "id": "UpyG5OwE9lca",
      "execution_count": 16,
      "outputs": []
    },
    {
      "cell_type": "code",
      "source": [
        "datetime.datetime.fromtimestamp(min(timestamps)/1000)"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "OHazTokA-FHq",
        "outputId": "4f9c7863-8bcb-4e6d-be6f-a7cde9b25da4"
      },
      "id": "OHazTokA-FHq",
      "execution_count": 17,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "datetime.datetime(1970, 1, 13, 12, 38, 28, 848000)"
            ]
          },
          "metadata": {},
          "execution_count": 17
        }
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "datetime.datetime.fromtimestamp(max(timestamps)/1000)"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "vqifEOxp-Hab",
        "outputId": "ef015866-db74-445e-b23f-a758a59d3090"
      },
      "id": "vqifEOxp-Hab",
      "execution_count": 18,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "datetime.datetime(2022, 11, 21, 11, 43, 26, 296000)"
            ]
          },
          "metadata": {},
          "execution_count": 18
        }
      ]
    },
    {
      "cell_type": "markdown",
      "source": [
        "A timestamp of less than year 2014 or 2021 is erroenous, since Brackets was first released in 2014 and became a community project in 2021. We will have to clean records."
      ],
      "metadata": {
        "id": "3dkTm025kZ5Y"
      },
      "id": "3dkTm025kZ5Y"
    },
    {
      "cell_type": "code",
      "source": [
        "err = [t for t in timestamps if t<1635984000000] # Nov 4, 2021 in ms since epoch\n",
        "err"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/"
        },
        "id": "uVtQq_ZzkryH",
        "outputId": "f2627338-b1e9-4276-a5f7-02eef1d0bb3b"
      },
      "id": "uVtQq_ZzkryH",
      "execution_count": 19,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "[1082308848,\n",
              " 1230760983934,\n",
              " 1230760923920,\n",
              " 1273032174652,\n",
              " 1273036194655,\n",
              " 1273032354655,\n",
              " 1262315084839]"
            ]
          },
          "metadata": {},
          "execution_count": 19
        }
      ]
    },
    {
      "cell_type": "code",
      "source": [
        "timestamps = [datetime.datetime.fromtimestamp(t/1000) for t in timestamps if t not in err]"
      ],
      "metadata": {
        "id": "-Bzr-Ab1l9EY"
      },
      "id": "-Bzr-Ab1l9EY",
      "execution_count": 20,
      "outputs": []
    },
    {
      "cell_type": "code",
      "source": [
        "plt.hist(np.asarray(timestamps))\n",
        "plt.xticks(rotation=45)"
      ],
      "metadata": {
        "colab": {
          "base_uri": "https://localhost:8080/",
          "height": 344
        },
        "id": "BPD9fHUumU_W",
        "outputId": "984a5f6f-c0c4-4243-8e2c-d93f50fe026f"
      },
      "id": "BPD9fHUumU_W",
      "execution_count": 21,
      "outputs": [
        {
          "output_type": "execute_result",
          "data": {
            "text/plain": [
              "(array([738156., 738187., 738215., 738246., 738276., 738307., 738337.,\n",
              "        738368., 738399., 738429., 738460., 738490.]),\n",
              " <a list of 12 Text major ticklabel objects>)"
            ]
          },
          "metadata": {},
          "execution_count": 21
        },
        {
          "output_type": "display_data",
          "data": {
            "text/plain": [
              "<Figure size 432x288 with 1 Axes>"
            ],
            "image/png": "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\n"
          },
          "metadata": {
            "needs_background": "light"
          }
        }
      ]
    }
  ],
  "metadata": {
    "kernelspec": {
      "display_name": "Python 3 (ipykernel)",
      "language": "python",
      "name": "python3"
    },
    "language_info": {
      "codemirror_mode": {
        "name": "ipython",
        "version": 3
      },
      "file_extension": ".py",
      "mimetype": "text/x-python",
      "name": "python",
      "nbconvert_exporter": "python",
      "pygments_lexer": "ipython3",
      "version": "3.8.13"
    },
    "colab": {
      "provenance": []
    }
  },
  "nbformat": 4,
  "nbformat_minor": 5
}