# GraphGist: Preview

## by Craig Taverner

 WarningThis GraphGist has not yet been submitted and approved for publication. If you're the developer, please submit for publication using the GraphGist Portal.

## Summary

Geoptima is an application for collecting passive and active events on mobile devices running on cellular networks. The event logs can be used to analyze the subscribers experience of the mobile network, and help track performance problems. For example, does iPhone 4 perform better or worse than iPhone 5 when accessing facebook in a specific region of the network. For more information on the product that creates this data, refer to the description of Geoptima. Alternatively watch my original videos on vimeo at https://vimeo.com/17321571.

This graphgist describes one way of collecting and managing data for a hypothetical mobile network called 'Operator X' in Sweden. My own phone, an HTC One, is the primary example device being shown, but most other information is anonymized.

## Data Model

The data model can be shown using a graphviz dot diagram.

The light nodes at the bottom represent the main information carriers, the JSON encoded files of events. This model does not manage the events themselves, but only the files, because the purpose is to make a per-file decision on where this data belongs. Who should have access to the data, and how to get to it. The rules overning this are managed in the green sub-graph, and the rest of the graph provides conventient structure for the kinds of queries we will make on the graph. This will make sense once we see the example queries below.

## Building the model with Cypher

We’ll build the model in stages. Starting with the simplest part, the users and projects. This sub-graph can be built using the cypher query below.

CREATE
(users {name:"Users"}),
(projects {name:"Projects"}),
(project:Project {name:"Operator X"}),
(craig:User {name:"Craig"}),
(jonas:User {name:"Jonas"}),
(john:User {name:"John"}),
(users)-[:user]->(craig),
(users)-[:user]->(jonas),
(users)-[:user]->(john),
(projects)-[:project]->(project),
(craig)-[:su]->(project),
(jonas)-[:su]->(project)

Now we have a simple graph with one project and three users, and for convenience, nodes for traversing to projects and users. We have also assigned users to projects, implying access rights. In the real application the access rights are handled in a far more complex way, but for this example we keep this simple because we want to focus on the event log data management.

The visualization has conveniently colored the users blue and the projects red, based on the fact that we used the Neo4j 2.0 standard of assigning labels to the nodes. Before building the more complex graph, lets perform a couple of simple queries.

## Querying the Graph

We will show a few useful queries on this graph, like:

• What rules does this project use to decide on data ownership?

• How many devices does use 'Craig' collect data for?

• How much data has 'Craig' collected?

• For how many days has Craig been collecting data?

Only the first query above is possible on the simple graph so far, so let’s try that before building more.

### The Project

Let’s do a basic query. Who has access to 'Operator X' data?

MATCH (u)-[:su]->(p)
WHERE p.name = 'Operator X'
RETURN u.name

Two of the three defined users have access to 'Operator X' data.

### Project allocation rules

Now the purpose of the project is to collect data. We need to define rules for which data to collect. Let’s start by adding two sets of rules, one for devices by their internal device identity number, and another based on the mobile network the device is actually running on. In a real network both types of rules are commonly used.

MATCH (project:Project)
WHERE project.name = 'Operator X'
CREATE
(filter_plmn:Filter {name:"Filter PLMN"}),
(filter_devices:Filter {name:"Filter Devices"}),
(f1:FilterPLMN {name:"Operator X", mcc:'240', mnc:'08'}),
(f2:FilterPLMN {name:"My Operator", mcc:'240', mnc:'18'}),
(f3:FilterPLMN {name:"XTele 2", mcc:'240', mnc:'28'}),
(fd:FilterDevices {name:"Test Devices", devices:[
'354436058915420','358506046830281','356451041578183','351503053121388','353328059211902'
]}),
(project)-[:filter]->(filter_plmn),
(project)-[:filter]->(filter_devices),
(filter_plmn)-[:filter]->(f1),
(filter_plmn)-[:filter]->(f2),
(filter_plmn)-[:filter]->(f3),
(filter_devices)-[:filter]->(fd)

Now we can ask the questions:

• How many operators are selected for?

• How many specific test devices are also included?

#### Operators Selected

How many operators will be selected during allocation of data to 'Operator X'?

MATCH (p:Project)-[:filter*]->(f:FilterPLMN)
WHERE p.name = 'Operator X'
RETURN f.name, f.mcc, f.mnc

If a device collects data while served by any one of the above three network operators, their data will be assocated with the project 'Operator X'.

#### Test Devices Selected

MATCH (p:Project)-[:filter*]->(f:FilterDevices)
RETURN f.name, f.devices

If any one of the five devices listed above collects data, it will be allocated to the project 'Operator X'.

### Device Management

So far we’ve looked only at the model used to decide what data should be collected. Now let’s look at the actual data collected. We’ll model sample data for one of the devices listed in the filters above, my own phone, an HTC One device with identity defined by the number '354436058915420'.

MATCH (craig:User)-[:su]->(project:Project)
WHERE craig.name = 'Craig' and project.name = 'Operator X'
CREATE
(devices {name:'Devices'}),
(sims {name:'SIM Cards'}),
(active_devices {name:'Active Devices'}),
(project)-[:active_devices]->(active_devices),
(devices)-[:device]->(d1:Device {name:'354436058915420'}),
(devices)-[:device]->(d2:Device {name:'358506046830281'}),
(devices)-[:device]->(d3:Device {name:'353328059211902'}),
(sims)-[:sim]->(s1:SIM {name:'240080000000001'}),
(sims)-[:sim]->(s2:SIM {name:'240080000000002'}),
(sims)-[:sim]->(s3:SIM {name:'240080000000003'}),
(sims)-[:sim]->(s4:SIM {name:'240080000000004'}),
(sims)-[:sim]->(s5:SIM {name:'240080000000005'}),
(d1)-[:assoc]->(devsim1:DeviceSIM {imei:'354436058915420',imsi:'240080000000001'}),
(d2)-[:assoc]->(devsim2:DeviceSIM {imei:'358506046830281',imsi:'240080000000002'}),
(d2)-[:assoc]->(devsim3:DeviceSIM {imei:'358506046830281',imsi:'240080000000003'}),
(d3)-[:assoc]->(devsim4:DeviceSIM {imei:'353328059211902',imsi:'240080000000004'}),
(d3)-[:assoc]->(devsim5:DeviceSIM {imei:'353328059211902',imsi:'240080000000005'}),
(s1)-[:assoc]->(devsim1),
(s2)-[:assoc]->(devsim2),
(s3)-[:assoc]->(devsim3),
(s4)-[:assoc]->(devsim4),
(s5)-[:assoc]->(devsim5),
(craig)-[:used_device]->(d1),
(craig)-[:used_sim]->(s1),
(active_devices)-[:active]->(devsim1),
(active_devices)-[:active]->(devsim2),
(active_devices)-[:active]->(devsim3),
(active_devices)-[:active]->(devsim4),
(active_devices)-[:active]->(devsim5),
(devsim1)-[:files]->(files {name:'Files'}),
(files)-[:date]->(x1:Date {date:'2013-12-30'}),
(files)-[:date]->(x2:Date {date:'2013-12-31'}),
(files)-[:date]->(x3:Date {date:'2014-01-01'}),
(files)-[:date]->(x4:Date {date:'2014-01-02'}),
(files)-[:date]->(x5:Date {date:'2014-01-03'}),
(files)-[:date]->(x6:Date {date:'2014-01-04'}),
(files)-[:date]->(x7:Date {date:'2014-01-05'}),
(files)-[:date]->(x8:Date {date:'2014-01-06'}),
(files)-[:date]->(x9:Date {date:'2014-01-07'}),
(x5)-[:json]->(f1:File {
name:'354436058915420_12345_12345.json',
start:'2014-01-03 12:12:12 GMT+01',
first:'2014-01-03 12:12:12.01 GMT+01',
last:'2014-01-03 12:17:32.57 GMT+01',
events:321,mcc:'240',mnc:'08',carrier:'Operator X'
}),
(x5)-[:json]->(f2:File {
name:'354436058915420_12346_12346.json',
start:'2014-01-03 12:17:33 GMT+01',
first:'2014-01-03 12:17:33.01 GMT+01',
last:'2014-01-03 12:23:21.76 GMT+01',
events:405,mcc:'240',mnc:'08',carrier:'Operator X'
}),
(x5)-[:json]->(f3:File {
name:'354436058915420_12347_12347.json',
start:'2014-01-03 12:21:22 GMT+01',
first:'2014-01-03 12:21:22.01 GMT+01',
last:'2014-01-03 12:27:13.17 GMT+01',
events:279,mcc:'240',mnc:'08',carrier:'Operator X'
}),
(x1)-[:next]->(x2),
(x2)-[:next]->(x3),
(x3)-[:next]->(x4),
(x4)-[:next]->(x5),
(x5)-[:next]->(x6),
(x6)-[:next]->(x7),
(x7)-[:next]->(x8),
(x8)-[:next]->(x9),
(f1)-[:next]->(f2),
(f2)-[:next]->(f3)

Now the graph starts to look quite complex. This is in fact a complete version of the graphvis example at the top of the page. We have less control over layout than with graphviz, so this is harder to make sense of, but now we can query it with cypher.

### Data collected

Let’s try two queries on this graph:

• How many events has Craig collected?

• For how many days has Craig been collecting data?

MATCH (u:User)-[:used_device]->(d)-[:assoc]->(ds)-[:files]->(f)-[:date]->(dd)
WHERE u.name = 'Craig'
RETURN u.name,ds.imei,ds.imsi,dd.date

The above query answers the second question. We traverse the graph from the user, through the devices used by that user, and the device-SIM card associations to the files and the days the files contain events for. However, if all we want is the number of days, we should not write the entire table. Rather we can use the count() function like:

MATCH (u:User)-[:used_device]->(d)-[:assoc]->(ds)-[:files]->(f)-[:date]->(dd)
WHERE u.name = 'Craig'
RETURN count(dd.date)

Now we can see that we have 9 days of data collected.

Since we now know how to use functions like count(), let’s try another function sum() for adding the event properties of all event files together:

MATCH (u:User)-[:used_device]->(d)-[:assoc]->(ds)-[:files]->(f)-[:date]->(dd)-[:json]->(json)
WHERE u.name = 'Craig'
RETURN count(json.events),sum(json.events),sum(json.events)/count(json.events),min(json.events),max(json.events)

So we can clearly see that we collected 1005 events in three files with an averate of 335 events per file.

## Summary

The above example was produced as part of some internal documentation while braintorming on possible data models for an upgrade of one of the data collection components of the Geoptima data collection system by AmanziTel. This is not an exact model of the actual data collection system in use, but does represent some of the decision logic being done by the real system. The use of Neo4j as a database for this has facilitated both the data modeling aspect of product management, as well as the ease of development of the actual products.

Table
Graph
Table!
Graph!
Error!